Assistant paquet PSADT C’est un outil qui vous permet de packagez vos applications sans avoir besoin d’écrire ou de modifier des scripts PowerShell. De plus, il est totalement gratuit.

Normes de nomenclature cohérentes pour les paquets de déploiement

C’est la convention de nommage d’XOAP. Tous les paquets d’installation et de configuration portent le nom de ce concept défini. Le concept de nommage est obligatoire pour tous les paquets car le front-end dépend de cette structure pour afficher les informations sur les paquets.

Structure de la convention de nommement :

TYPE_Manufacturer_Name_Version_OperatingSystem_Platform_Language

Convention de nommage cohérente des paquets

Selon l'exemple ci-dessous, la convention de nommage ainsi que les options possibles sont décrites :

APP_Citrix_VDAServer_1912_W2K19_x64_Any

• Type: L'appellation « APP » désigne « Applications ». Les valeurs possibles pour ce type sont les suivantes :
  • APP = Application
  • USR = Configuration de l’utilisateur
  • SYS = Configuration système
  • DRV = Conducteur
• Fabricant: dans ce cas, c’est Citrix pour l’application
• Produit: dans ce cas, c’est le serveur VDA
• Version: du produit – dans ce cas, 1912
• Système d'exploitation: dans ce cas, il s’agit de W2K19. Les valeurs possibles pour les systèmes d’exploitation sont les suivantes :
  • W7
  • W8
  • W81
  • W10
  • W11
  • W2K8
  • W2K8R2
  • W2K12
  • W2K12R2
  • W2K16
  • W2K19
  • W2K22
• Architecture: dans ce cas, c’est x64. Les valeurs possibles pour cette architecture sont :
  • x86
  • x64
  • Tout
• Langue: dans ce cas, il est défini sur « tout ». Les valeurs possibles sont :
  • EN
  • DE
  • Tout

Les paquets ne doivent pas utiliser de espaces ; seuls les sous-caractères sont autorisés pour séparer les zones.

The post Intro to PSADT Package Wizard appeared first on XOAP.

Le système PowerShell App Deployment Toolkit a été développé (et testé) pour fonctionner avec une large gamme de systèmes d’exploitation, allant de Windows XP à Windows 8.1 (et leurs équivalents pour Windows Server), afin de garantir une compatibilité à l’échelle de l’entreprise. Les exigences système sont les suivantes :

• PowerShell 2.0
• Windows NT 5.1 et versions ultérieures

Bien que nous ayons tenté de maintenir cette compatibilité avec les versions antérieures du toolkit tout au long de sa durée de vie, le niveau de tests effectués sur des systèmes d’exploitation plus anciens tels que XP et Vista est limité, car la majorité des tests sont effectués sur les dernières versions d’OS. Cependant, le toolkit bénéficie d’une large adoption dans le monde des entreprises, de PME à multinationales, ce qui confère une sécurité et une assurance quant à la qualité du toolkit, qui a été testé sur des centaines de milliers de clients à travers le monde.

Informations relatives aux licences

Le PSADT est sous licence GNU Lesser General Public License. Ce paragraphe reproduit l'emplacement original de cette licence. https://psappdeploytoolkit.com/.

PowerShell App Deployment Toolkit – Fournit un ensemble de fonctions permettant de réaliser les tâches courantes de déploiement d’applications sous Windows.

PSApppDeployToolkit est sous licence LGPLv3 – (C) 2024 l'PSAppDeployToolkit équipe (Sean Lillis, Dan Cunningham et Muhammad Mashwani).

Ce programme est un logiciel libre : vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence publique générale moins restrictive de GNU, telle que publiée par la Free Software Foundation, soit la version 3 de cette licence, soit toute version ultérieure. Ce programme est distribué dans l’espoir qu’il sera utile, mais sans aucune garantie, même pas implicite de commercialisation ou de conformité à un usage particulier. Consultez la Licence publique générale de GNU pour plus de détails. Vous auriez dû recevoir une copie de la Licence publique générale de GNU avec ce programme. Si ce n’est pas le cas, consultez Licences GNU.

Pour toute question complémentaire, veuillez contacter les créateurs de l’AppDeployment Toolkit PowerShell.

Cadre PSADT

Téléchargez notre Cadre PSADT personnalisé (nécessaire pour les informations spécifiques au frontend) et extraire le contenu dans un dossier local, par exemple “ C:\toolkit ”. La structure du dossier devrait ressembler à ceci :

Vous pouvez télécharger le code source à partir de notre dépôt GitHub. xoaap-psadt-framework-template.

Si vous utilisez notre outil de configuration PSADT, assurez-vous d’utiliser la version 1.0.603.0 pour les versions PSADT inférieures à 3.9.0 et la version 1.1.610 pour les versions PSADT supérieures à 3.9.0.

Le programme d'installation PSADT peut être trouvé dans votre Application Management abonnement.

Notre framework personnalisé comprend certaines extensions qui le rendent plus utilisable lors des déploiements avec SCCM et notre implémentation XOAP. Consultez l'extension.ps1 qui se trouve dans le framework personnalisé pour plus d'informations.

Le modèle PSADT peut être personnalisé selon vos besoins. Si vous avez besoin d’extensions, n’hésitez pas à modifier la fonction du cadre et à l’utiliser comme base de votre application.

Assurez-vous de ne pas enlever Enregistrement-Installation une partie de l'extension.ps1 car sinon le module PowerShell DSC responsable de l'installation des applications ne fonctionnera plus.

Fichiers du dossier Packages

Créez un dossier sur votre machine ou un partage de fichiers. Ce dossier servira à stocker les paquets d’installation créés, par exemple “C:\packages”.

The post Prerequisites appeared first on XOAP.

Vous pouvez créer un nouveau dossier à l’intérieur du dossier racine ou cliquer sur Ajouter un paquet (Alt+P).

Emballage

Une nouvelle fenêtre s’ouvre. C’est la première étape du processus d’emballage.

Choisissez le type du forfait. Vous pouvez choisir entre :

• Application
• Configuration de l’utilisateur
• Configuration du système
• Conducteur

Selon ce que vous choisissez, le dossier du nouveau package PSADT sera automatiquement précédé de l'extension .

• APP
• USR
• SYS
• DRV

Prenons l’exemple d’un emballage. Nous devons maintenant inclure les fichiers binaires de l’application. Les fichiers d’installation sont stockés dans le répertoire Files, les fichiers de support (par exemple, les fichiers de transformation ou les fichiers de licence) dans le répertoire Support Files. Sélectionnez « ADD Directory » si vous souhaitez ajouter des répertoires avec des sous-répertoires ou bien sélectionnez Ajouter des fichiers si vous souhaitez ajouter un seul fichier d'installation.

Dans cet exemple, nous allons ajouter un fichier MSI simple : profilemgmt_x64.msi. Vous le verrez dans l’aperçu du fichier (comme le montre l’image ci-dessus). Maintenant, cliquez sur SUIVANT ou appuyez sur F9.

Variables d'application

Dans cette section, nous configurons les variables d’application PSADT. Ces variables sont utilisées pour créer le nom de dossier final. Dans ce cas : “APP_Citrix_Profilemanagement_203025008_W10_x64_Any”.

Vendeur

Si vous utilisez un MSI, les champs Vendeur, Nom et Version sont automatiquement propagés dans les champs. Le champ Vendeur ne doit contenir que les caractères suivants : a-z, A-Z, 0-9, – et un espace.

Nom

C’est le nom de l’application. Si vous utilisez un MSI, le champ « nom » est automatiquement propagé. Les champs « fournisseur » et « nom » ne peuvent contenir que les caractères suivants : a-z, A-Z, 0-9, – et espace.

Version

Voici la version de l’application. Si vous utilisez un MSI, le champ « nom » est automatiquement propagé. Les champs « fournisseur » et « nom » ne peuvent contenir que les caractères suivants : a-z, A-Z, 0-9, – et espace.

Système d'exploitation

Vous pouvez choisir parmi la liste suivante :

• Windows 7
• Windows 8
• Windows 8.1
• Windows 10
• Windows Server 2008
• Windows Server 2008 R2
• Windows Server 2012
• Windows Server 2012 R2
• Windows Server 2016
• Windows Server 2019

Architecture

Vous pouvez choisir parmi la liste suivante :

• x86
• x64
• Tout

Langue

Vous pouvez choisir parmi la liste suivante :

• Tout
• EN
• DE
• NL
• DA
• ES
• PT
• FR
• Informatique
• JA
• NB
• SV

Révision

Le champ de révision est utilisé pour définir la version du package. Chaque fois qu'un package est modifié, le champ de révision doit être mis à jour par l'application de paqueterie.

Version du script

Ce champ définit la version globale du script du package d'application PSADT.

Date de la copie

C’est la date de la modification du script.

Écrivain du script

Ce champ sert à insérer le créateur du package d'application PSADT. Le Wizard de création de package PSADT transfère l'utilisateur actuellement connecté depuis une machine Windows vers l'auto-remplissage de ce champ.

Variables d'application personnalisées

Vous pouvez également ajouter des variables personnalisées au script que vous pouvez utiliser pour paramétrer davantage le package d’application.

Les paramètres suivants sont disponibles :

• string
• string []
• char
• char[]
• bool
• commutateur
• int
• int[]
• decimal
• unique
• double

Lorsque vous aurez terminé d’ajuster toutes les valeurs, cliquez sur SUIVANT ou appuyez sur F9.

Installation

Vous êtes maintenant dans l’espace d’installation où vous définirez les phases d’installation suivantes :

• Phase de pré-installation : c’est la phase où vous pouvez définir les commandes PowerShell qui doivent être exécutées avant l’installation.

• Phase d'installation : c'est la phase où se déroule l'installation réelle du logiciel.

• Phase post-installation : dans cette phase, vous pouvez définir les commandes qui doivent être exécutées après l’installation.

Zones importantes du Wizard du paquet

Les domaines suivants nécessitent une attention particulière dans cette fenêtre :

Ligne de commande du script résultant

C’est la ligne de commande qui sera insérée dans la zone de script.

Constructeur de fonctionnalités de kit d’outils

C’est la zone principale que l’on peut utiliser pour insérer les commandes de script nécessaires.

Code script pour l'installation

C’est la zone où se trouve le code script final.

Passons à autre chose et ouvrons Fonctionnalité du Toolkit Builder. Vous voyez une barre de recherche en bas à gauche. C’est là que vous pouvez rechercher les fonctions disponibles dans le cadre PSADT. Dans notre cas, nous recherchons le terme ” *msi ” et la recherche renvoie une fonction appelée “ Execute-MSI ”. Cliquez sur cette fonction.

Vous voyez qu'une deuxième fenêtre apparaît au milieu ; cliquez sur cette fenêtre pour l'activer. Cette fenêtre contient tous les paramètres disponibles dans la fonction. Les colonnes en gris indiquent les champs requis ; il est donc nécessaire d'avoir un chemin.

Nous pouvons choisir autres paramètres en cliquant dessus. Nous choisirons Action même.

Vous voyez qu'une troisième fenêtre s'affiche. Cliquez sur cette troisième fenêtre. Elle sert à configurer les paramètres. Action C’est un champ déroulant qui est automatiquement créé à partir des options fournies par le framework. Le La voie Le paramètre peut être ajusté manuellement ou en utilisant le Valeur Browser qui s’ouvre automatiquement lorsque vous sélectionnez le champ « chemin ».

Valeur Browser

Le Navigateur de valeurs possède les fonctionnalités suivantes :

• Les cheminsVous pouvez naviguer vers les chemins disponibles sur votre système.
• Les annuairesIl s’agit des répertoires que vous avez intégrés lors de la première étape de l’emballage, lorsque vous avez intégré le fichier MSI.
• FichiersC’est le dossier “ Fichiers ” dans le cadre de PSADT.
• SupportFilesC’est le dossier “ SupportFiles ” dans le cadre de PSADT.
• Variables: Ici vous pouvez trouver toutes les variables d’environnement disponibles sur votre système.

Cliquez sur Fichiers Pour ajouter le MSI Nous l’avons intégré dans la première étape. Le chemin vers le fichier est automatiquement inséré avec la variable pour le répertoire. Choisissez Installer comme une action.

Choisissez maintenant l'option INSTALLATION Dans la zone inférieure de la fenêtre, placez votre curseur à l’endroit où vous souhaitez insérer le commandement. Nous devrions placer le curseur quelque part en dessous des éléments suivants :

##

Regardez bien Commandes script résultant La zone située au-dessus du constructeur de fonctions Toolkit. Vous voyez le commandement suivant :Executer l'application MSI -Path "$dirFiles\profilemgt_x64.msi" -Action "Installer" copie

Cliquez sur ADD Un bouton sur le côté droit permet d’insérer le commandement dans le formulaire. INSTALLATION zone.

Vous pouvez maintenant enregistrer ce paquet. Le processus d’emballage sera terminé et vous serez redirigé vers l’écran de configuration. Tableau de bord Consultez l’endroit où vous pouvez retrouver votre colis. Vous pouvez cliquer sur le colis pour le modifier à nouveau. Passez à l’onglet INSTALLATION la même zone encore une fois.

Cliquez sur INSTALLER. L’installation du package commencera sur votre machine locale. Une fois l’installation terminée, vous verrez une quatrième fenêtre dans le code du script pour INSTALLATION avec le RESULTAT. Ici, vous trouverez le journal d’installation qui est également enregistré. C:\Windows\Logs\Software. Vous pouvez modifier l’emplacement du fichier de journal dans les paramètres du framework. Pour modifier l’emplacement, allez dans Paramètres zone du Guide de configuration du paquet.

Gardez à l’esprit que cette modification s’applique à tous les paquets consécutifs que vous créez ultérieurement à l’intérieur du programme Package Wizard.

Si vous changez l’emplacement du fichier de journal, le frontend ne pourra plus afficher les fichiers de journal. Assurez-vous donc que vous avez des raisons exceptionnelles de modifier la configuration standard.

Nous disposons désormais d’une installation fonctionnelle du package. Passons maintenant à la phase suivante : DÉINSTALLATION Définissez la zone en choisissant SUIVANT ou en appuyant sur F9.

Désinstallation

Cette zone fonctionne exactement comme la INSTALLATION zone. La seule différence est DÉINSTALLATION Zones disponibles :

• Phase de pré-désinstallation : c’est la phase où vous pouvez définir les commandes PowerShell à exécuter avant le processus de désinstallation. DÉINSTALLATION
• Déménagement de la phase : c’est la phase où se déroule réellement DÉINSTALLATION le logiciel prend place
• Phase post-installation : dans cette phase, vous pouvez définir les commandes à exécuter après l'installation. DÉINSTALLATION

Utilisons le même processus pour configurer DÉINSTALLATION. Tout d’abord, utilisez le constructeur de fonctions Toolkit pour rechercher “ MSI ”.

Choisissez la fonction Executer-msi et sélectionnez la deuxième fenêtre pour choisir les paramètres.

Passons à la troisième fenêtre et configurez-la. Action Entrez le paramètre et remplissez le patch dans le fichier d’installation grâce au navigateur de valeurs.

Choisissez l'option DÉINSTALLATION ouvrez la fenêtre et placez le curseur à l’endroit où vous souhaitez insérer le commandement. Ajoutez le commandement en cliquant sur ADD bouton.

Vous êtes maintenant prêt à enregistrer le paquet ou à lancer le processus de DÉINSTALLATION processer sur votre machine locale. Suivez les instructions ci-dessous. DÉINSTALLER Un bouton permet d’installer le package. Une fois de plus, le fichier de journal de l’installation apparaît dans une quatrième fenêtre. Si tout s’est bien passé, vous pouvez enregistrer le package. Cliquez sur SAVE Fermer ou appuyer sur un bouton F5.

Nous sommes de retour dans le Tableau de bord voir.

Zone de réalisation

La zone « Réalisation » vous présente un résumé des fichiers intégrés et des blocs de script. Elle vous montre également le code du script de déploiement résultant.

C’est tout. Vous pouvez maintenant procéder à l’upload du package vers XOAP.

Principaux problèmes connus

L’utilisation du cmdlet PowerShell “ Write-Output ” dans le package PSADT entraîne l’apparition d’une erreur 400 lors de l’installation de l’application via XOAP. L’utilisation de “ Write-Output ” entraîne automatiquement l’utilisation de “ Write-Host ”.

The post Create packages appeared first on XOAP.

Si vous n’êtes pas un utilisateur de XOAP

Vous n'avez pas besoin d'être utilisateur de XOAP pour installer notre logiciel gratuit PSADT Package Wizard. Il suffit de : Téléchargez-le ici En quelques clics, créez plus rapidement des packs que jamais auparavant.

Si vous êtes un utilisateur de XOAP

Veuillez télécharger les fichiers d’installation à l’intérieur de votre compte.

Attention à l'archive XOAP_PackageWizard_1.0.603.0.zip située dans votre Workspace :

Téléchargez le fichier et extraitez-le dans un dossier de votre choix. Vous pouvez soit lancer l’installation à partir du package PSADT, soit l’installer à l’aide du fichier setup.exe contenu dans le package PSADT. fichiers un dossier.

Configuration

Commencez l'assistant de configuration du package PSADT via Mise en marche du menu d'accueil ou le icône sur le bureau.

Acceptez la licence et continuez Démarrage:

Tout d'abord, nous devons configurer chemin du toolkit et le chemin de la bibliothèque de packages:

Insérer C:\toolkit dans le champ « chemin du toolkit » et C:\packages dans le champ « chemin vers le package ». Dès que vous aurez correctement intégré le chemin vers le toolkit, vous verrez que les champs de configuration du toolkit seront propagés avec les paramètres standard du toolkit PSADT.

N'hésitez pas à les modifier selon vos besoins. Ces paramètres s'appliqueront à tous les nouveaux paquets que vous créerez avec le programme PSADT Package Wizard. Les paquets existants ne seront pas modifiés.

Cliquez sur Économiser.

Passons maintenant à la vue des paquets. Nous sommes prêts à commencer la création de nouveaux paquets PSADT.

The post Install and configure appeared first on XOAP.

Contenu du script

$packagepath = Lire-Host " Veuillez saisir le chemin vers le dossier PSADT Packages "
$folderlist = Obtenir les éléments d'un dossier à partir du chemin $packagepath -Directory

fonction ZipFiles( fichier_ $zip, $source_dir )
{
   Add-Type - Système d'assemblage.IO.Compression.FileSystem
   $compressionLevel = [System.IO.Compression.CompressionLevel]::Optimal
   [System.IO.Compression.ZipFile]::CreateFromDirectory($source_dir,
        $zipfilename, $compressionLevel, $false)
}

Foreach ($Fichier dans $la liste des dossiers)
{ZipFiles "($ $Folder.Fullname).zip" "($ $Folder.Fullname)"}

Utilisez ce script pour vous assurer que la structure du dossier dans le fichier compressé est créée comme prévu lors de notre processus de téléchargement. Certains zip créent des sous-dossiers au sein d’un fichier zip. Dans ce cas, le processus de téléchargement risque d’échouer.

The post Upload packages appeared first on XOAP.

Tout ce que vous devez savoir sur Set-StrictMode est disponible ici ici.

Packs de déploiement paramétrables

Paramétrisez toujours vos paquets d’installation sans imposer des valeurs fixes ; lors du déploiement, vous pouvez transmettre ces valeurs au package. 

The post Security appeared first on XOAP.