Installer à l’aide de la ligne de commande
Cet article s’applique à l’installation de composants sur des machines avec systèmes d’exploitation Windows. Pour de plus amples informations sur les VDA pour systèmes d’exploitation Linux, consultez la documentation Virtual Delivery Agent Linux.
Important :
Cet article explique comment émettre des commandes d’installation du produit. Avant de procéder à une installation, consultez la section Préparer l’installation. Cet article contient des descriptions des programmes d’installation disponibles.
Pour pouvoir suivre la progression de l’exécution de la commande en cours et des valeurs de retour, vous devez être l’administrateur d’origine ou utiliser l’option Exécuter en tant qu’administrateur. Pour plus d’informations, veuillez consulter la documentation des commandes Microsoft.
En complément des commandes d’installation directes, des exemples de scripts sont fournis sur le fichier ISO du produit que vous pouvez utiliser pour installer, mettre à niveau ou supprimer des VDA dans Active Directory. Pour de plus amples informations, consultez Installer les VDA à l’aide de scripts.
Utiliser le programme d’installation du produit entier
Pour accéder à l’interface de la ligne de commande du programme d’installation du produit complet :
- Téléchargez le pack du produit auprès de Citrix. Des informations d’identification de compte Citrix sont requises pour accéder au site de téléchargement.
- Décompressez le fichier. Éventuellement, gravez un DVD du fichier ISO.
- Ouvrez une session sur le serveur sur lequel vous installez les composants, à l’aide d’un compte d’administrateur local.
- Insérez le DVD dans le lecteur ou montez le fichier ISO.
- À partir du répertoire
\x64\XenDesktop Setupdu support d’installation, exécutez la commande appropriée.
Pour installer les composants principaux
Exécutez la commande XenDesktopServerSetup.exe avec les options répertoriées dans la section Options de ligne de commande pour l’installation des composants principaux.
Pour installer un VDA
Exécutez la commande XenDesktopVDASetup.exe avec les options répertoriées dans la section Options de ligne de commande pour l’installation d’un VDA.
Pour installer le Serveur d’impression universelle
Suivez les instructions de la section Installer le Serveur d’impression universelle à l’aide de la ligne de commande.
Pour installer le service d’authentification fédérée
Citrix vous recommande d’utiliser l’interface graphique.
Pour installer le service de réinitialisation en libre-service des mots de passe
Suivez les instructions de la documentation du service de réinitialisation en libre-service des mots de passe.
Utiliser le programme d’installation de VDA autonome
Des informations d’identification de compte Citrix sont requises pour accéder au site de téléchargement. vous devez soit disposer de privilèges d’administrateur avant de démarrer l’installation, soit utiliser l’option Exécuter en tant qu’administrateur.
- Téléchargez le pack approprié auprès de Citrix :
| Nom du composant sur la page de téléchargement | Nom de fichier du programme d’installation |
|---|---|
| Virtual Delivery Agent <version> OS de serveur | VDAServerSetup.exe |
| Virtual Delivery Agent <version> OS de bureau | VDAWorkstationSetup.exe |
| Virtual Delivery Agent <version> OS de bureau - Services de base | VDAWorkstationCoreSetup.exe |
- Vous pouvez extraire les fichiers du pack dans un répertoire existant, puis exécuter la commande d’installation, ou uniquement exécuter le pack.
Pour extraire les fichiers avant de les installer, utilisez /extract avec le chemin d’accès absolu, par exemple : .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. (Le répertoire doit exister. Sinon, l’extraction échoue.) Ensuite, dans une commande séparée, exécutez XenDesktopVdaSetup.exe à partir du répertoire contenant le contenu extrait (dans l’exemple précédent, CitrixVDAInstallMedia). Utilisez les options valides répertoriées dans la section Options de ligne de commande pour l’installation d’un VDA.
Pour exécuter le package téléchargé, exécutez son nom : VDAServerSetup.exe, VDAWorkstationSetup.exe ou VDAWorkstationCoreSetup.exe. Utilisez les options valides répertoriées dans la section Options de ligne de commande pour l’installation d’un VDA.
Si vous connaissez le programme d’installation de la version complète du produit :
-
Exécutez le programme d’installation autonome
VDAServerSetup.exeouVDAWorkstationSetup.execomme s’il s’agissait de la commandeXenDesktopVdaSetup.exesauf pour le nom. -
Le programme d’installation
VDAWorkstationCoreSetup.exeest différent, car il prend en charge un sous-ensemble des options disponibles avec les autres programmes d’installation.
Options de ligne de commande pour l’installation des composants principaux
Les options suivantes sont valides lors de l’installation des composants principaux à l’aide de la commande XenDesktopServerSetup.exe. Pour de plus amples informations sur les options disponibles, consultez la section Installer les composants principaux.
/components <composant> [,<composant>] …
Liste séparée par des virgules des composants à installer ou supprimer. Les valeurs autorisées sont :
CONTROLLER: Controller
DESKTOPSTUDIO: Studio
DESKTOPDIRECTOR: Director
LICENSESERVER: Serveur de licences Citrix
Si cette option est omise, tous les composants sont installés (ou supprimés, si l’option /remove est également spécifiée).
(Dans les versions antérieures à 7.15 LTSR CU6, les valeurs valides incluaient StoreFront. Pour les versions 7.15 LTSR CU6 et ultérieures, utilisez la commande d’installation dédiée de StoreFront indiquée à la section Installer StoreFront.)
/configure_firewall
Ouvre tous les ports du pare-feu Windows utilisés par les composants installés, si le service Pare-feu Windows est en cours d’exécution, même si le pare-feu n’est pas activé. Si vous utilisez un pare-feu tiers ou aucun pare-feu, vous devez ouvrir les ports manuellement.
/disableexperiencemetrics
Empêche l’envoi automatique des analyses collectées au cours de l’installation, de la mise à niveau ou de la suppression à Citrix.
/exclude
Empêche l’installation de fonctions, services ou technologies séparés par des virgules, entourés de guillemets droits. Les valeurs autorisées sont :
Local Host Cache Storage (LocalDB): empêche l’installation de la base de données utilisée pour le cache d’hôte local. Cette option n’a aucun effet sur l’installation de SQL Server Express pour une utilisation en tant que base de données du site.
Smart Tools Agent : empêche l’installation de l’agent Citrix Smart Tools.
Remarque :
À partir de CU4, Smart Tools n’est plus inclus dans le programme d’installation. Les instances de Smart Tools installées auparavant restent intactes.
/help ou /h
Affiche la commande d’aide.
/installdir <directory>
Répertoire vide existant où les composants seront installés. Valeur par défaut = c:\Program Files\Citrix.
/logpath <path>
Emplacement du fichier journal. Le dossier spécifié doit exister. Le programme d’installation ne le crée pas. Valeur par défaut = "%TEMP%\Citrix\XenDesktop Installer"
/no_remote_assistance
(Valide uniquement lors de l’installation de Director.) Désactive la fonctionnalité d’observation utilisateur qui utilise l’Assistance à distance Windows.
/noreboot
Empêche un redémarrage après l’installation. (Pour la plupart des composants principaux, aucun redémarrage n’est activé par défaut).
/nosql
Empêche l’installation de Microsoft SQL Server Express sur le serveur sur lequel vous installez le Controller. Si cette option est omise, SQL Server Express est installé pour être utilisé en tant que base de données du site. (Cette option n’a aucun effet sur l’installation de SQL Server Express LocalDB utilisé pour le cache d’hôte local).
/quiet ou /passive
Aucune interface utilisateur ne s’affiche lors de l’installation. La seule preuve de l’installation est dans le Gestionnaire des tâches Windows. Si cette option n’est pas utilisée, l’interface graphique démarre.
/remove
Supprime les composants principaux spécifiés avec l’option /components.
/removeall
Supprime tous les principaux composants installés.
/sendexperiencemetrics
Envoie automatiquement les analyses collectées au cours de l’installation, de la mise à niveau ou de la suppression à Citrix. Si cette option est omise (ou que /disableexperiencemetrics est spécifié), les analyses sont collectées localement, mais pas envoyées automatiquement.
/tempdir <répertoire>
Répertoire qui contient les fichiers temporaires durant l’installation. Valeur par défaut = c:\Windows\Temp.
/xenapp
Installe XenApp. Si cette option est omise, XenDesktop est installé.
Exemples : Installer les composants principaux
La commande suivante installe un Controller XenDesktop, Studio, le système de licences Citrix et SQL Server Express sur un serveur. Les ports de pare-feu requis pour les communications de composants sont ouverts automatiquement.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
La commande suivante installe un contrôleur XenApp, Studio, et SQL Server Express sur le serveur. Les ports de pare-feu requis pour les communications de composants seront ouverts automatiquement.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
Options de ligne de commande pour l’installation d’un VDA
Les options suivantes sont valides avec une ou plusieurs des commandes suivantes : XenDesktopVDASetup.exe, VDAServerSetup.exe, VDAWorkstationSetup.exe ou VDAWorkstationCoreSetup.exe.
/baseimage
Valide uniquement lors de l’installation d’un VDA pour OS de bureau sur une VM. Permet d’utiliser des Personal vDisk avec une image principale. Pour plus d’informations, consultez la section Personal vDisk.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe.
/components <composant>[,<composant>]
Liste séparée par des virgules des composants à installer ou supprimer. Les valeurs autorisées sont :
VDA: Virtual Delivery Agent
PLUGINS : Citrix Receiver pour Windows (CitrixReceiver.exe)
Par exemple, pour installer le VDA, mais pas Citrix Receiver, spécifiez l’option /components vda.
Si cette option est omise, tous les composants sont installés.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe. Ce programme d’installation ne peut pas installer Citrix Receiver.
/controllers “<contrôleur> [<contrôleur>] […]”
Noms de domaines complets (FQDN) des Controller avec lesquels le VDA peut communiquer, séparés par des espaces et entourés de guillemets droits. Ne spécifiez pas à la fois les options /site_guid et /controllers.
/disableexperiencemetrics
Envoie automatiquement les analyses collectées au cours de l’installation, de la mise à niveau ou de la suppression à Citrix.
/enable_framehawk_port
Ouvre les ports UDP utilisés par Framehawk. Valeur par défaut = false
/enable_hdx_3d_pro
Installe le VDA en mode HDX 3D Pro.
/enable_hdx_ports
Ouvre les ports du pare-feu Windows requis par le VDA et les fonctionnalités activées (sauf l’assistance à distance Windows), si le service Pare-feu Windows est détecté, même si le pare-feu n’est pas activé. Si vous utilisez un autre pare-feu ou aucun pare-feu, vous devez configurer le pare-feu manuellement. Pour obtenir des informations sur le port, consultez la section Ports réseau.
Pour ouvrir les ports UDP utilisés par le transport adaptatif HDX, spécifiez l’option /enable_hdx_udp_ports et l’option /enable_hdx_ports.
/enable_hdx_udp_ports
Ouvre les ports UDP, dans le pare-feu Windows, qui sont requis par le transport adaptatif HDX, si le Service pare-feu Windows est détecté, même si le pare-feu n’est pas activé. Si vous utilisez un autre pare-feu ou aucun pare-feu, vous devez configurer le pare-feu manuellement. Pour obtenir des informations sur le port, consultez la section Ports réseau.
Pour ouvrir les ports supplémentaires utilisés par le VDA, spécifiez l’option /enable_hdx_ports et l’option /enable_hdx_udp_ports.
/enable_real_time_transport
Active ou désactive l’utilisation d’UDP pour les paquets audio (Real-Time Audio Transport pour l’audio). L’activation de cette fonctionnalité peut améliorer les performances audio. Incluez l’option /enable_hdx_ports si vous souhaitez que les ports UDP soient ouverts automatiquement si le service Pare-feu Windows est détecté.
/enable_remote_assistance
Active la fonctionnalité d’observation dans l’Assistance à distance Windows pour l’utiliser avec Director. Si vous spécifiez cette option, l’Assistance à distance Windows ouvre les ports dynamiques dans le pare-feu.
/exclude “<component>”[,”<component>”]
Empêche l’installation d’un ou de plusieurs composants facultatifs séparés par des virgules, entourés de guillemets droits. Par exemple, l’installation ou la mise à niveau d’un VDA sur une image qui n’est pas gérée par MCS ne nécessite pas les composants Personal vDisk ou Machine Identity Service. Les valeurs autorisées sont :
Personal vDiskMachine Identity ServiceCitrix User Profile ManagerCitrix User Profile Manager WMI PluginCitrix Universal Print ClientCitrix Telemetry ServiceCitrix Personalization for App-V - VDA
L’exclusion de Citrix Profile Management de l’installation (à l’aide de l’option /exclude "Citrix User Profile Manager") affecte la surveillance et la résolution des problèmes des VDA avec Citrix Director. Sur les pages Détails de l’utilisateur et Point de terminaison, les panneaux Personnalisation et Durée de l’ouverture de session échouent. Sur les pages Tableau de bord et Tendances, le panneau Durée moyenne d’ouverture de session affiche les données uniquement pour les machines sur lesquelles Profile Management est installé.
Même si vous n’utilisez pas une solution de gestion de profils utilisateur tierce, Citrix vous recommande d’installer et d’exécuter Citrix Profile Management Service. L’activation de Citrix Profile Management Service n’est pas nécessaire.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe. Ce programme d’installation exclut automatiquement un grand nombre de ces éléments.
/h ou /help
Affiche la commande d’aide.
/hdxflashv2only
Empêche l’installation des fichiers binaires d’ancienne génération de la redirection Flash, pour une sécurité accrue.
Cette option n’est pas disponible dans l’interface graphique.
/installdir <directory>
Répertoire vide existant où les composants seront installés. Valeur par défaut = c:\Program Files\Citrix.
/logpath <path>
Emplacement du fichier journal. Le dossier spécifié doit exister. Le programme d’installation ne le crée pas. Valeur par défaut = "%TEMP%\Citrix\XenDesktop Installer"
Cette option n’est pas disponible dans l’interface graphique.
/masterimage
Valide uniquement lors de l’installation de VDA sur une VM. Définit le VDA comme image principale.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe.
/no_mediafoundation_ack
Reconnaît que Microsoft Media Foundation n’est pas installé, et que plusieurs fonctionnalités multimédias de HDX ne seront pas installées et ne fonctionneront pas. Si cette option est omise et Media Foundation n’est pas installé, l’installation de VDA échoue. La plupart des éditions Windows prises en charge sont fournies avec Media Foundation, à l’exception des éditions N.
/nocitrixwddm
Valide uniquement sur les machines Windows 7 qui ne contiennent pas un pilote WDDM. Désactive l’installation du pilote Citrix WDDM.
Cette option n’est pas disponible dans l’interface graphique.
/nodesktopexperience
Valide uniquement lors de l’installation d’un VDA pour OS de serveur. Empêche l’activation de la fonctionnalité Expérience de bureau améliorée. Cette fonctionnalité est contrôlée par le paramètre de stratégie Citrix Expérience de bureau améliorée.
/noreboot
Empêche un redémarrage après l’installation. Le VDA ne peut être utilisé qu’après un redémarrage.
/noresume
Par défaut, lorsqu’un redémarrage de la machine est nécessaire pendant une installation, le programme d’installation reprend automatiquement une fois le redémarrage terminé. Pour remplacer la valeur par défaut, spécifiez /noresume. Cela peut être utile si vous devez réinstaller le support ou si vous souhaitez capturer des informations lors d’une installation automatisée.
/optimize
Valide uniquement lors de l’installation de VDA sur une VM. Permet l’optimisation des VDA exécutés dans une VM sur un hyperviseur. L’optimisation de VM comprend la désactivation des fichiers en mode déconnecté, la désactivation de la défragmentation en arrière-plan et la réduction de la taille du journal d’événements. Ne spécifiez pas cette option pour les déploiements Remote PC Access. Pour plus d’informations, consultez CTX224676.
/portnumber <port>
Valide uniquement si l’option /reconfig est spécifiée. Numéro de port à activer pour les communications entre le VDA et le Controller. Le port configuré précédemment est désactivé, à moins qu’il s’agisse du port 80.
/quiet ou /passive
Aucune interface utilisateur ne s’affiche lors de l’installation. La seule preuve de l’installation et de la configuration est dans le Gestionnaire des tâches Windows. Si cette option n’est pas utilisée, l’interface graphique démarre.
/reconfigure
Personnalise les paramètres VDA précédemment configurés lorsqu’il est utilisé avec les options /portnumber, /controllers ou /enable_hdx_ports. Si vous spécifiez cette option sans spécifier également l’option /quiet, l’interface graphique de personnalisation de VDA démarre.
/remotepc
Valide uniquement pour les déploiements Remote PC Access. Exclut l’installation des composants suivants sur un OS de bureau :
- Citrix Personalization pour App-V
- Citrix User Profile Manager
- Citrix User Profile Manager WMI Plugin
- Machine Identity Service
- Personal vDisk
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe. Ce programme d’installation exclut automatiquement l’installation de ces composants.
/remove
Supprime les composants spécifiés avec l’option /components.
/removeall
Supprime tous les composants VDA installés.
/sendexperiencemetrics
Envoie automatiquement les analyses collectées au cours de l’installation, de la mise à niveau ou de la suppression à Citrix. Si cette option est omise (ou que /disableexperiencemetrics est spécifié), les analyses sont collectées localement, mais pas envoyées automatiquement.
/servervdi
Installe un VDA pour OS de bureau sur un serveur Windows pris en charge. Évitez cette option lors de l’installation d’un VDA pour OS de serveur sur un serveur Windows. Avant d’utiliser cette option, consultez la section Server VDI.
Utilisez cette option uniquement avec le programme d’installation du produit entier VDA. Cette option n’est pas disponible dans l’interface graphique.
/site_guid <guid>
Identificateur global unique (GUID) de l’unité d’organisation Active Directory du site. Associe un bureau virtuel à un site lorsque vous utilisez Active Directory pour la découverte (la mise à jour automatique est la méthode recommandée et la méthode de découverte par défaut). Le GUID du site est une propriété de site affichée dans Studio. Ne spécifiez pas à la fois les options /site_guid et /controllers.
/tempdir <répertoire>
Répertoire sur lequel stocker les fichiers temporaires durant l’installation. Valeur par défaut = c:\Windows\Temp.
Cette option n’est pas disponible dans l’interface graphique.
/virtualmachine
Valide uniquement lors de l’installation de VDA sur une VM. Remplace la détection par le programme d’installation d’une machine physique, où les informations du BIOS transmises aux VM les font passer pour des machines physiques.
Cette option n’est pas disponible dans l’interface graphique.
Exemples : Installer un VDA
Installer un VDA avec le programme d’installation complet du produit
La commande suivante installe un VDA pour OS de bureau et Citrix Receiver à l’emplacement par défaut sur une VM. Ce VDA sera utilisé comme une image principale. Le VDA s’enregistrera initialement auprès du Controller sur le serveur appelé « Contr-Main » dans le domaine « mondomaine ». Le VDA utilisera des Personal vDisks, la fonctionnalité d’optimisation et l’Assistance à distance Windows.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance
Installer un VDA pour OS de bureau avec le programme d’installation autonome VDAWorkstationCoreSetup
La commande suivante installe un VDA Core Services sur un OS de bureau à utiliser dans un déploiement VDI ou Remote PC Access. Citrix Receiver et les autres services non fondamentaux ne sont pas installés. L’adresse d’un Controller est spécifiée, et les ports du Service de pare-feu Windows seront automatiquement ouverts. L’administrateur doit gérer les redémarrages.
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
Personnaliser un VDA à l’aide de la ligne de commande
Une fois que vous avez installé un VDA, vous pouvez personnaliser plusieurs paramètres. À partir du répertoire \x64\XenDesktop Setup du support du produit, exécutez la commande XenDesktopVdaSetup.exe, à l’aide d’une ou plusieurs des options suivantes, qui sont décrites dans la section Options de ligne de commande pour l’installation d’un VDA.
-
/reconfigure(option requise lors de la personnalisation d’un VDA) -
/hou/help /quiet/noreboot/controllers-
/portnumberport /enable_hdx_ports
Installer le Serveur d’impression universelle à l’aide de la ligne de commande
Exécutez l’une des commandes suivantes sur chaque serveur d’impression :
- Sur un système d’exploitation 32 bits pris en charge : à partir du répertoire
\x86\Universal Print Server\sur le support d’installation Citrix, exécutezUpsServer_x86.msi. - Sur un système d’exploitation 64 bits pris en charge : à partir du répertoire
\x64\Universal Print Server\sur le support d’installation Citrix, exécutezUpsServer_x64.msi.
Après avoir installé le composant du serveur d’impression universelle sur vos serveurs d’impression, configurez ce dernier à l’aide des instructions de la section Provisionner les imprimantes.
Dans cet article
- Utiliser le programme d’installation du produit entier
- Utiliser le programme d’installation de VDA autonome
- Options de ligne de commande pour l’installation des composants principaux
- Exemples : Installer les composants principaux
- Options de ligne de commande pour l’installation d’un VDA
- Exemples : Installer un VDA
- Personnaliser un VDA à l’aide de la ligne de commande
- Installer le Serveur d’impression universelle à l’aide de la ligne de commande