Installer l’agent App Layering
L’agent App Layering permet à l’appliance ou à une machine d’packaging exécuter des commandes PowerShell localement. Si vous fournissez les informations d’identification appropriées, l’agent peut exécuter des commandes PowerShell en tant qu’utilisateur spécifique.
Quand l’agent est requis
L’agent App Layering est nécessaire si vous envisagez de :
- Lancez des scripts à l’aide des configurations de connecteur.
- Exécutez l’appliance App Layering dans Microsoft Hyper-V.
- Publier des images en couches dans Citrix Provisioning.
Vous installez l’agent aux emplacements suivants :
- Sur tous les serveurs Hyper-V que vous envisagez d’utiliser pour la création de couches ou la publication d’images.
- Sur tous les serveurs Citrix Provisioning sur lesquels vous envisagez de publier des images en couches.
- Dans les emplacements où vos configurations de connecteurs exécutent des scripts PowerShell.
Enregistrement de l’agent auprès de l’appliance
Le programme d’installation de l’agent de superposition d’application vous invite à enregistrer l’agent auprès d’une appliance App Layering. Si vous n’enregistrez pas l’agent pendant l’installation, vous pouvez l’enregistrer manuellement ultérieurement. Toutefois, les scripts PowerShell ne s’exécutent pas tant que l’agent n’est pas enregistré auprès du dispositif.
Conditions préalables
Avant d’installer l’agent App Layering, assurez-vous que le système sur lequel vous installez l’agent répond aux exigences suivantes :
- Un compte doté de privilèges d’administrateur
- .NET 4.5
- PowerShell 3.0 ou version ultérieure
- composant logiciel enfichable PowerShell. Avant d’utiliser l’agent App Layering sur un serveur Citrix Provisioning Services, vous devez vous assurer que le composant logiciel enfichable PowerShell est installé. Consultez les étapes pour enregistrer manuellement l’agent auprès de l’appliance.
Si vous avez déjà installé l’agent App Layering, vous pouvez télécharger les versions mises à jour à partir de la page de téléchargements Citrix. Le package d’installation de l’agent est inclus dans le téléchargement ZIP App Layering.
Pour télécharger l’agent App Layering
- Accédez à la page d’accueil de Citrix, puis cliquez sur Connexion.
- Cliquez sur Téléchargements et sélectionnez Citrix App Layering dans la liste.
- Sur la page Citrix App Layering, sous Citrix App Layering > Product Software, cliquez sur Citrix App Layering.
- En bas de la page, cliquez sur Outils.
- Cliquez sur le fichier de téléchargementde l’agent Citrix App Layering. Le fichier citrix_app_layering_agent_installer.exe est téléchargé sur votre ordinateur.
Installer l’agent App Layering
Le programme d’installation de l’agent de superposition d’application vous invite à enregistrer l’agent auprès d’une appliance App Layering. Si vous n’enregistrez pas l’agent pendant l’installation, vous pouvez l’enregistrer manuellement ultérieurement. Toutefois, n’oubliez pas que l’agent doit être enregistré auprès de l’appliance avant que les scripts PowerShell puissent être exécutés.
-
À l’aide d’un compte doté de privilèges d’administrateur, connectez-vous au système sur lequel vous installez l’agent.
-
Copiez le fichier Citrix_app_layering_agent_installer.exe vers un emplacement approprié sur le serveur.
-
Exécutez Citrix_app_layering_agent_installer.exe en tant qu’administrateur et, lorsque vous y êtes invité, entrez le chemin d’accès au répertoire dans lequel vous souhaitez installer l’agent App Layering. L’emplacement par défaut est C:\Program Files (x86) \ Citrix \ Agent.
Le programme d’installation de l’agent vérifie que toutes les conditions préalables sont présentes. Si des conditions préalables sont manquantes, le programme d’installation le signale et se quitte sans procéder à l’installation.
-
Le programme d’installation vous invite à entrer un numéro de port de l’agent. Vous pouvez accepter le numéro de port par défaut (8016) ou en spécifier un autre si le port par défaut est déjà utilisé.
-
Le programme d’installation vous invite à entrer les informations d’identification (adresse, nom d’utilisateur et mot de passe) de votre appliance App Layering. Enregistrez l’agent App Layering auprès de l’appliance en entrant l’adresse IP et les informations d’identification d’ouverture de session d’un utilisateur de la console de gestion sur l’appliance disposant de privilèges d’administrateur (par exemple, les informations d’identification que vous utilisez pour ouvrir une session sur la console de gestion).
Remarque :
Si l’appliance App Layering n’est pas disponible ou si vous choisissez de ne pas s’inscrire avec elle maintenant, vous pouvez vous inscrire manuellement ultérieurement à l’aide de la procédure décrite dans Enregistrer avec l’appliance App Layering manuellement.
-
Cliquez sur Terminer pour quitter l’assistant.
Enregistrez manuellement l’agent App Layering auprès de l’appliance
Enregistrez l’agent App Layering auprès de l’appliance.
Si l’agent App Layering n’est pas enregistré auprès d’une appliance App Layering pendant l’installation, vous pouvez l’enregistrer ultérieurement en suivant la procédure suivante.
-
En tant qu’administrateur, connectez-vous au serveur sur lequel vous avez installé l’agent App Layering.
-
Ouvrez une fenêtre de commande (cmd.exe) en tant qu’administrateur et accédez au répertoire où l’agent App Layering est installé. L’emplacement par défaut est C:\Program Files (x86) \ Citrix \ Agent.
-
Exécutez la commande PowerShell suivante :
Enable-PSRemoting -
Vérifiez que le port 8016 est ouvert en exécutant cette commande :
netstat -a -
Ouvrez une fenêtre de commande (cmd.exe) en tant qu’administrateur et accédez au répertoire où l’agent App Layering est installé. L’emplacement par défaut est :
C:\Program Files (x86)\Citrix\Agent -
Exécutez la commande suivante en utilisant l’adresse IP de l’appliance indiquée :
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
Lorsque vous y êtes invité, entrez le mot de passe d’un utilisateur disposant de privilèges d’administrateur dans la console de gestion de l’appliance.
-
Une fois le processus d’inscription terminé, un message s’affiche pour vous informer de la réussite du processus. L’enregistrement de l’agent App Layering apparaît dans le journal d’audit du service de gestion.
Si le processus échoue, examinez le fichier journal de l’agent dans le répertoire d’installation :
C:\Program Files (x86) \ Citrix \ agent \ Logs \ applayering.agent.log
Vous pouvez également afficher l’aide pour les options de ligne de commande de l’agent App Layering en exécutant la commande suivante :
Citrix.AppLayering.Agent.Service.exe /? -
Exécutez la commande PowerShell pour charger les fichiers DLL appropriés sur Citrix Provisioning Server.
Pour PVS 7.7 et versions ultérieures :
-
Accédez à :
C:\program files\citrix\provisioning services console -
Exécutez la commande :
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll
Pour PVS 7.1 — 7.6 :
-
Accédez à :
C:\program files\citrix\provisioning services console -
Exécutez la commande :
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll
Dans le cas où certains composants logiciels enfichables Citrix Provisioning et Broker ne sont pas enregistrés, par exemple après une mise à jour Windows majeure, découvrez lesquels.
-
-
Exécutez la commande suivante pour répertorier les composants logiciels enfichables enregistrés :
get-pssnapin -registered -
Consultez cet article pour obtenir des instructions sur la réinscription de tous les composants logiciels enfichables.