Installer des VDA à l’aide de la ligne de commande
Introduction
Cet article explique comment installer, mettre à niveau et personnaliser des VDA sur des machines avec systèmes d’exploitation Windows.
Cet article explique comment émettre des commandes d’installation de VDA. Avant de commencer l’installation, consultez la section Installer des VDA pour en savoir plus sur l’installation, les programmes d’installation et les informations que vous spécifiez pendant l’installation.
Installer un VDA à partir de la ligne de commande
Pour installer un VDA (et voir le progrès d’exécution des commandes et les valeurs de retour), vous devez disposer d’autorisations d’administrateur élevées ou utiliser Exécuter en tant qu’administrateur.
- Sur la machine sur laquelle vous installez le VDA, connectez-vous à Citrix Cloud.
- Dans le menu supérieur gauche, sélectionnez Mes services > DaaS.
- Sur le côté supérieur droit, cliquez sur Téléchargements et sélectionnez Télécharger VDA. Vous serez redirigé vers la page de téléchargement du VDA. Recherchez le programme d’installation du VDA que vous souhaitez et cliquez sur Télécharger fichier.
-
Une fois le téléchargement terminé, exécutez le programme d’installation. Utilisez les options décrites dans cet article.
-
Pour le VDA pour OS multi-session, exécutez
VDAServerSetup.exe
-
Pour le VDA pour OS mono-session, exécutez
VDAWorkstationSetup.exe
-
Pour le VDA pour services de base OS mono-session, exécutez
VDAWorkstationCoreSetup.exe
-
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’extrait échoue.) Ensuite, dans une commande séparée, exécutez la commande appropriée, en utilisant les options valides répertoriées dans cet article.
-
Pour
VDAServerSetup_XXXX.exe
, exécutez<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
-
Pour
VDAWorkstationCoreSetup_XXXX.exe
, exécutez<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe
-
Pour
VDAWorkstationSetup_XXXX.exe
, exécutez<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
Options de ligne de commande pour installer un VDA
Les options suivantes sont valides avec une ou plusieurs des commandes : VDAServerSetup.exe
, VDAWorkstationSetup.exe
et VDAWorkstationCoreSetup.exe
.
-
/components component[,component]
Liste séparée par des virgules des composants à installer ou supprimer. Les valeurs autorisées sont :
-
VDA : Virtual Delivery Agent
-
PLUGINS : application Citrix Workspace pour Windows
Pour installer le VDA et l’application Citrix Workspace, spécifiez
/components vda,plugins
.Si l’option
plugins
est omise, seul le VDA est installé (pas l’application Citrix Workspace).Cette option n’est pas valide lors de l’utilisation du programme d’installation
VDAWorkstationCoreSetup.exe
. Ce programme d’installation ne peut pas installer l’application Citrix Workspace. -
-
/controllers “controller [*controller*]…”
Noms de domaines complets (FQDN) séparés par des espaces et entourés de guillemets droits des Citrix Cloud Connector avec lesquels le VDA peut communiquer. 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_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
, en plus de l’option/enable_hdx_ports
. -
/enable_hdx_udp_ports
Ouvre les ports UDP, dans le pare-feu Windows, que le transport adaptatif HDX utilise, 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 utilisés par le VDA, spécifiez l’option
/enable_hdx_ports
, en plus de l’option/enable_hdx_udp_ports
. -
/enable_real_time_transport
Active ou désactive l’utilisation d’UDP pour les paquets audio (RealTime 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 de l’Assistance à distance Windows pour l’utiliser avec les fonctions Surveiller. Si vous spécifiez cette option, l’Assistance à distance Windows ouvre les ports dynamiques dans le pare-feu.
-
/enablerestore ou /enablerestorecleanup
(Valide uniquement pour les VDA mono-session) Active le retour automatique au point de restauration, en cas d’échec de l’installation ou de la mise à niveau du VDA.
Si l’installation ou la mise à niveau se termine avec succès :
-
/enablerestorecleanup
indique au programme d’installation de supprimer le point de restauration. -
/enablerestore
indique au programme d’installation de conserver le point de restauration, même s’il n’a pas été utilisé.
Pour plus d’informations, consultez la section Restauration en cas d’échec de l’installation ou de la mise à niveau.
-
-
/enable_ss_ports
Ouvre les ports, dans le pare-feu Windows, qui sont requis pour le partage d’écran, 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.
-
/exclude “component”[,”component”]
Empêche l’installation d’un ou de plusieurs composants facultatifs séparés par des virgules et entourés de guillemets droits. Par exemple, l’installation ou la mise à niveau d’un VDA sur une image gérée par MCS nécessite le composant Machine Identity Service. Les valeurs autorisées sont :
- Machine Identity Service
- Citrix Profile Management
- Plug-in WMI de Citrix Profile Management
- Citrix Personalization pour AppV - VDA
- Outils de prise en charge Citrix
- Pilote E/S de MCS Citrix
- Agent de mise à niveau de Citrix VDA
- Citrix Rendezvous V2
L’exclusion de Citrix Profile Management de l’installation (
/exclude "Citrix Profile Management"
) affecte la surveillance et le dépannage des VDA à partir de l’onglet Surveiller. 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 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.
Si vous envisagez d’utiliser MCS pour provisionner des machines virtuelles, n’excluez pas Machine Identity Service.
Si vous spécifiez à la fois
/exclude
et/includeadditional
avec le même nom de composant, ce composant n’est pas installé.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.
-
/includeadditional “component”[,”component”] …
Inclut l’installation d’un ou de plusieurs composants facultatifs séparés par des virgules et entourés de guillemets droits. Les noms des composants sont sensibles à la casse.
Cette option peut être utile lorsque vous créez un déploiement Remote PC Access et souhaitez installer des composants qui ne sont pas inclus par défaut. Les valeurs autorisées sont :
- Citrix Profile Management
- Plug-in WMI de Citrix Profile Management
- Citrix Personalization pour AppV - VDA
- Outils de prise en charge Citrix
- Pilote E/S de MCS Citrix
- Agent de mise à niveau de Citrix VDA
- Citrix Rendezvous V2
- Couche de personnalisation de l’utilisateur
- Outil d’enregistrement de VDA Citrix WebSocket
Si vous spécifiez à la fois
/exclude
et/includeadditional
avec le même nom de composant, ce composant n’est pas installé. -
/installdir directory
Répertoire vide existant où les composants seront installés. Valeur par défaut : c:\Program Files\Citrix.
-
/install_mcsio_driver
Ne pas utiliser. Utiliser plutôt
/includeadditional "Citrix MCS IODriver"
ou/exclude "Citrix MCS IODriver"
-
/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 machine virtuelle. Définit le VDA comme image. Cette option est équivalente à
/mastermcsimage
.Cette option n’est pas valide lors de l’utilisation du programme d’installation
VDAWorkstationCoreSetup.exe
. -
/mastermcsimage
Indique que cette machine sera utilisée comme image avec Machine Creation Services. Cette option est équivalente à
/masterimage
. -
/masterpvsimage
Indique que cette machine sera utilisée comme image avec Citrix Provisioning ou un outil de provisioning tiers (tel que Microsoft System Center Configuration Manager).
-
/no_mediafoundation_ack
Reconnaît que Microsoft Media Foundation n’est pas installé, et que plusieurs fonctionnalités multimédias de HDX ne sont pas installées et ne fonctionnent 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.
-
/nodesktopexperience
Valide uniquement lors de l’installation d’un VDA pour OS multi-session. 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. -
/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. -
/proxyconfig “adresse ou chemin d’accès au fichier PAC”
Valide uniquement si la commande contient
/includeadditional "Citrix Rendezvous V2"
. Adresse ou chemin d’accès au fichier PAC du proxy à utiliser avec le protocole Rendezvous. Pour plus d’informations sur les fonctionnalités, consultez Protocole Rendezvous.- Format d’adresse du proxy :
http://<url-or-ip>:<port>
- Format du fichier PAC :
http://<url-or-ip>:<port>/<path>/<filename>.pac
- Format d’adresse du proxy :
-
/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 (OS mono-session) ou les connexions négociées (OS multi-session).
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_appdisk_ack
Autorise le programme d’installation du VDA à désinstaller le plug-in AppDisks VDA s’il est installé.
-
/remove_pvd_ack
Autorise le programme d’installation du VDA à désinstaller Personal vDisk s’il est installé.
-
/remove
Supprime les composants spécifiés avec l’option
/components
. -
/removeall
Supprime le VDA. Ne supprime pas l’application Citrix Workspace (si elle est installée).
-
/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 mono-session sur un serveur Windows pris en charge. Évitez cette option lors de l’installation d’un VDA multi-session sur un serveur Windows. Avant d’utiliser cette option, consultez la section Server VDI.
-
/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 directory
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 machine virtuelle. Remplace la détection par le programme d’installation d’une machine physique, où les informations du BIOS transmises aux machine virtuelle les font passer pour des machines physiques.
Cette option n’est pas disponible dans l’interface graphique.
-
/xendesktopcloud
Indique que le VDA est installé dans un déploiement de Citrix DaaS (Citrix Cloud).
Exemples : Installer un VDA
-
Installer un VDA sur un OS multi-session. La commande suivante installe un VDA sur un OS multi-session.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage
Le VDA sera utilisé comme image.
-
Installer un VDA d’OS multi-session ou un VDA d’OS mono-session. La commande suivante installe un VDA d’OS multi-session ou un VDA d’OS mono-session.
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot
Séparez le nom de domaine complet de chaque Delivery Controller par une virgule. Notez que
XXXX
représente la version du VDA. -
Installer un VDA Core Services sur un OS mono-session. La commande suivante installe un VDA Core Services sur un OS mono-session à utiliser dans un déploiement VDA ou Remote PC Access.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
L’application Citrix Workspace et les autres services non fondamentaux ne sont pas installés. L’adresse d’un Cloud Connector est spécifiée, et les ports du Service de pare-feu Windows sont automatiquement ouverts. L’administrateur gère les redémarrages.
Personnaliser un VDA à l’aide de la ligne de commande
Une fois que vous avez installé un VDA, vous pouvez personnaliser plusieurs paramètres. Exécutez XenDesktopVDASetup.exe
, en utilisant une ou plusieurs des options suivantes.
-
/reconfigure
(option requise lors de la personnalisation d’un VDA) -
/h
ou/help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports
Autres ressources
-
Pour passer en revue l’ensemble du processus de configuration, reportez-vous à la section Planifier et créer un déploiement.