Installer des VDA à l’aide de la ligne de commande
Introduction
Cet article s’applique à l’installation, à la mise à niveau et à la personnalisation des Virtual Delivery Agents (VDA) sur des machines exécutant des systèmes d’exploitation Windows.
Cet article décrit comment émettre des commandes d’installation de VDA. Avant de commencer une installation, consultez Installer des VDA pour en savoir plus sur les considérations d’installation, les programmes d’installation et ce que vous spécifiez lors de l’installation.
Installer un VDA à partir de la ligne de commande
Pour installer un VDA (et voir la progression de l’exécution de la commande et les valeurs de retour), vous devez disposer de privilèges d’administrateur élevés ou utiliser Exécuter en tant qu’administrateur.
- Sur la machine où vous installez le VDA, connectez-vous à Citrix Cloud.
- Dans le menu supérieur gauche, sélectionnez Solutions > DaaS.
- Dans la partie supérieure droite, cliquez sur Téléchargements et sélectionnez Télécharger le VDA. Vous êtes 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 le fichier.
-
Une fois le téléchargement terminé, exécutez son nom. Utilisez les options décrites dans cet article.
-
Pour le Virtual Delivery Agent de système d’exploitation multi-session, exécutez
VDAServerSetup.exe -
Pour le Virtual Delivery Agent de système d’exploitation mono-session, exécutez
VDAWorkstationSetup.exe -
Pour le Virtual Delivery Agent de services de base de système d’exploitation mono-session, exécutez
VDAWorkstationCoreSetup.exe
-
Pour extraire les fichiers avant de les installer, utilisez /extract avec le chemin absolu, par exemple .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. (Le répertoire doit exister. Sinon, l’extraction échoue.) Ensuite, dans une commande distincte, 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 composant[,composant]
Liste de composants à installer ou à supprimer, séparés par des virgules. Les valeurs valides 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
pluginsest 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 “contrôleur [contrôleur]…”
Noms de domaine complets (FQDN) des Citrix Cloud Connectors avec lesquels le VDA peut communiquer, séparés par des espaces et placés entre guillemets droits. Ne spécifiez pas les options
/site_guidet/controllerssimultanément. -
/disableexperiencemetrics
Empêche le téléchargement automatique vers Citrix des analyses collectées lors de l’installation, de la mise à niveau ou de la suppression.
-
/enable_hdx_ports
Ouvre les ports du pare-feu Windows requis par le VDA et les fonctionnalités activées (à l’exception de 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 pare-feu différent ou aucun pare-feu, vous devez configurer le pare-feu manuellement. Pour plus d’informations sur les ports, consultez Ports réseau.
Pour ouvrir les ports UDP requis 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 du pare-feu Windows 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 pare-feu différent ou aucun pare-feu, vous devez configurer le pare-feu manuellement. Pour plus d’informations sur les ports, consultez 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 (transport audio en temps réel pour l’audio). L’activation de cette fonctionnalité peut améliorer les performances audio. Incluez l’option
/enable_hdx_portssi vous souhaitez que les ports UDP soient ouverts automatiquement lorsque le service Pare-feu Windows est détecté. -
/enable_remote_assistance
Active la fonctionnalité d’observation dans l’Assistance à distance Windows pour une utilisation avec les fonctions Surveillance. 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) Permet le retour automatique au point de restauration si l’installation ou la mise à niveau du VDA échoue.
Si l’installation/mise à niveau se termine avec succès :
-
/enablerestorecleanupindique au programme d’installation de supprimer le point de restauration. -
/enablerestoreindique au programme d’installation de conserver le point de restauration, même s’il n’a pas été utilisé.
Pour plus de détails, consultez Restaurer en cas d’échec d’installation ou de mise à niveau.
-
-
/enable_ss_ports
Ouvre les ports du pare-feu Windows 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 pare-feu différent ou aucun pare-feu, vous devez configurer le pare-feu manuellement.
-
/exclude “composant”[,”composant”]
Empêche l’installation d’un ou plusieurs composants facultatifs séparés par des virgules, chacun étant placé entre 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 valides sont :
- Machine Identity Service
- Citrix Profile Management
- Plug-in WMI Citrix Profile Management
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Agent de mise à niveau 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 la console Monitor. Sur les pages Détails de l’utilisateur et Point de terminaison, le panneau Personnalisation et le panneau Durée de l’ouverture de session échouent. Sur les pages Tableau de bord et Tendances, le panneau Durée moyenne de l’ouverture de session affiche les données uniquement pour les machines sur lesquelles Profile Management est installé.Même si vous utilisez une solution de gestion de profils tierce, Citrix vous recommande d’installer et d’exécuter le service Citrix Profile Management. L’activation du service Citrix Profile Management n’est pas requise.
Si vous prévoyez d’utiliser MCS pour provisionner des machines virtuelles, n’excluez pas le service Machine Identity Service.
Si vous spécifiez à la fois
/excludeet/includeadditionalavec le même nom de composant, le 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 de nombreux éléments. -
/h ou /help
Affiche l’aide de la commande.
-
/includeadditional “composant”[,”composant”] …
Inclut l’installation d’un ou plusieurs composants facultatifs séparés par des virgules, chacun étant placé entre guillemets droits. Les noms des composants sont sensibles à la casse.
Cette option peut être utile lorsque vous créez un déploiement d’accès PC à distance et que vous souhaitez installer des composants qui ne sont pas inclus par défaut. Les valeurs valides sont :
- Citrix Profile Management
- Plug-in WMI Citrix Profile Management
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Agent de mise à niveau Citrix VDA
- Citrix Rendezvous V2
- Couche de personnalisation utilisateur
- Outil d’enregistrement VDA Citrix Web Socket
Si vous spécifiez à la fois
/excludeet/includeadditionalavec le même nom de composant, ce composant n’est pas installé. -
/installdir répertoire
Répertoire vide existant où les composants seront installés. Par défaut = c:\Program Files\Citrix.
-
/install_mcsio_driver
Ne pas utiliser. Utilisez plutôt
/includeadditional "Citrix MCS IODriver"ou/exclude "Citrix MCS IODriver". -
/logpath chemin
Emplacement du fichier journal. Le dossier spécifié doit exister. Le programme d’installation ne le crée pas. Par défaut = “%TEMP%\Citrix\XenDesktop Installer”
Cette option n’est pas disponible dans l’interface graphique.
-
/masterimage
Valide uniquement lors de l’installation d’un VDA sur une machine virtuelle. Configure le VDA en tant qu’image. Cette option est équivalente à
/mastermcsimage.Cette option n’est pas valide lors de l’utilisation du programme d’installation
VDAWorkstationCoreSetup.exe. -
/mastermcsimage
Spécifie que cette machine sera utilisée comme image avec Machine Creation Services. Cette option est équivalente à
/masterimage. -
/masterpvsimage
Spécifie que cette machine sera utilisée comme image avec Citrix Provisioning™ ou un outil de provisionnement 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édia HDX™ ne sont pas installées et ne fonctionnent pas. Si cette option est omise et que Media Foundation n’est pas installé, l’installation du VDA échoue. La plupart des éditions de Windows prises en charge sont livrées avec Media Foundation déjà installé, à l’exception des éditions N.
-
/nodesktopexperience
Valide uniquement lors de l’installation d’un VDA de système d’exploitation multi-session. Empêche l’activation de la fonctionnalité Expérience de bureau améliorée. Cette fonctionnalité est également 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 pas être utilisé avant 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 annuler la valeur par défaut, spécifiez
/noresume. Cela peut être utile si vous devez remonter le support ou si vous souhaitez capturer des informations pendant une installation automatisée. -
/portnumber port
Valide uniquement lorsque l’option
/reconfigest spécifiée. Numéro de port à activer pour les communications entre le VDA et le Controller. Le port précédemment configuré est désactivé, sauf s’il s’agit du port 80. -
/proxyconfig “adresse ou chemin du fichier PAC”
Valide uniquement si la commande contient
/includeadditional "Citrix Rendezvous V2". L’adresse ou le chemin du fichier PAC du proxy à utiliser avec le protocole Rendezvous. Pour plus de détails sur les fonctionnalités, consultez Protocole Rendezvous.- Format d’adresse du proxy :
http://<url-or-ip>:<port> - Format de fichier PAC :
http://<url-or-ip>:<port>/<path>/<filename>.pac
- Format d’adresse du proxy :
-
/quiet ou /passive
Aucune interface utilisateur n’apparaît pendant l’installation. La seule preuve du processus d’installation et de configuration se trouve dans le Gestionnaire des tâches de Windows. Si cette option est omise, l’interface graphique se lance.
-
/reconfigure
Personnalise les paramètres VDA précédemment configurés lorsqu’il est utilisé avec les options
/portnumber,/controllersou/enable_hdx_ports. Si vous spécifiez cette option sans spécifier également l’option/quiet, l’interface graphique de personnalisation du VDA se lance. -
/remotepc
Valide uniquement pour les déploiements d’accès PC distant (OS à session unique) ou les connexions intermédié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 VDA AppDisks™ 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. Il ne supprime pas l’application Citrix Workspace (si elle est installée).
-
/sendexperiencemetrics
Envoie automatiquement à Citrix les analyses collectées lors de l’installation, de la mise à niveau ou de la suppression. Si cette option est omise (ou si l’option
/disableexperiencemetricsest spécifiée), les analyses sont collectées localement, mais ne sont pas envoyées automatiquement. -
/servervdi
Installe un VDA d’OS à session unique sur un serveur Windows pris en charge. Omettez cette option lors de l’installation d’un VDA multi-session sur un serveur Windows. Avant d’utiliser cette option, consultez VDI de serveur.
-
/site_guid guid
Identificateur global unique (GUID) de l’unité d’organisation (UO) Active Directory du site. Cela associe un bureau virtuel à un site lorsque vous utilisez Active Directory pour la découverte (la mise à jour automatique est la méthode de découverte recommandée et par défaut). Le GUID du site est une propriété du site affichée dans Studio. Ne spécifiez pas à la fois les options
/site_guidet/controllers. -
/tempdir répertoire
Répertoire pour stocker les fichiers temporaires pendant l’installation. Par défaut = c:\Windows\Temp.
Cette option n’est pas disponible dans l’interface graphique.
-
/virtualmachine
Valide uniquement lors de l’installation d’un VDA sur une machine virtuelle. Remplace la détection par le programme d’installation d’une machine physique, lorsque les informations du BIOS transmises aux machines virtuelles les font apparaître comme des machines physiques.
Cette option n’est pas disponible dans l’interface graphique.
-
/xendesktopcloud
Indique que le VDA est installé dans un déploiement 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 /masterimageLe VDA sera utilisé comme image.
-
Installer un VDA d’OS multi-session ou un VDA d’OS à session unique. La commande suivante installe un VDA d’OS multi-session ou un VDA d’OS à session unique.
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /norebootSéparez chaque nom de domaine complet (FQDN) de Delivery Controller™ par une virgule. Notez que
XXXXreprésente la version du VDA. -
Installer un VDA de services principaux sur un OS à session unique. La commande suivante installe un VDA de services principaux sur un OS à session unique pour une utilisation dans un déploiement d’accès PC distant ou de VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /norebootL’application Citrix Workspace et les autres services non essentiels ne sont pas installés. L’adresse d’un Cloud Connector est spécifiée, et les ports du service Pare-feu Windows sont automatiquement ouverts. L’administrateur gère les redémarrages.
Personnaliser un VDA à l’aide de la ligne de commande
Après avoir installé un VDA, vous pouvez personnaliser plusieurs paramètres. Exécutez XenDesktopVDASetup.exe, en utilisant une ou plusieurs des options suivantes.
-
/reconfigure(obligatoire lors de la personnalisation d’un VDA) -
/hou/help /quiet/noreboot/controllers/portnumber port/enable_hdx_ports
Où aller ensuite
-
Pour consulter l’ensemble du processus de configuration, reportez-vous à Planifier et créer un déploiement.