Installer à l’aide de la ligne de commande
Important :
Si vous effectuez une mise à niveau et que votre version actuelle utilise ou est dotée du logiciel Personal vDisk ou AppDisks, reportez-vous à la section Suppression de PvD, AppDisks et d’hôtes non pris en charge.
Introduction
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 Linux Virtual Delivery Agents.
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.
Si vous tentez d’installer ou de mettre à niveau sur une version de Windows non prise en charge par cette version de Citrix Virtual Apps and Desktops, un message vous renvoie vers des informations décrivant vos options. Voir Systèmes d’exploitation antérieurs.
Pour plus d’informations sur la façon dont Citrix présente le résultat de l’installation des composants, veuillez consulter la section Codes de retour de l’installation de Citrix.
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 Setup
du support d’installation, exécutez la commande appropriée.Pour installer les composants principaux : exécutez
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
XenDesktopVDASetup.exe
avec les options répertoriées dans Options de ligne de commande pour l’installation d’un VDA.Pour installer StoreFront : exécutez
CitrixStoreFront-x64.exe
dans le dossierx64 > StoreFront
sur le support d’installation.Pour installer le serveur d’impression universelle : suivez les instructions de la section Options de ligne de commande pour l’installation d’un serveur d’impression universelle.
Pour installer le service d’authentification fédérée : Citrix vous recommande d’utiliser l’interface graphique.
Pour installer l’enregistrement de session : suivez les instructions de la section Enregistrement de session.
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 à 2003, les valeurs valides incluaient
STOREFRONT
. Pour les versions 2003 et ultérieures, utilisez la commande d’installation dédiée de StoreFront indiquée à la section Utiliser le programme d’installation du produit entier. -
-
/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 “feature”[,”feature”]
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.
-
-
/help ou /h
Affiche la commande d’aide.
-
/ignore_hw_check_failure
Permet à l’installation ou à la mise à niveau de Delivery Controller de continuer, même si les vérifications matérielles échouent (par exemple, en raison d’une mémoire RAM insuffisante). Pour plus d’informations, consultez la section Vérification du matériel.
-
/ignore_site_test_failure
Valable uniquement pendant la mise à niveau du Controller. En général, les échecs de test de site sont ignorés et la mise à niveau continue. Si cette commande est omise (ou définie sur false), tout échec de test de site entraîne l’échec du programme d’installation, sans effectuer la mise à niveau. Valeur par défaut = false
Lors d’une mise à niveau, cette option est ignorée si une version de SQL Server non prise en charge est détectée. Pour plus d’informations, consultez la section Vérification de la version de SQL Server.
-
/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_pending_reboot_check
Lors de l’installation ou de la mise à niveau de composants de base, empêche la vérification d’un redémarrage en attente depuis une installation Windows précédente sur la machine.
-
/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).
-
/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. -
/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 directory
Répertoire qui contient les fichiers temporaires durant l’installation. Valeur par défaut = c:\Windows\Temp.
-
/xenapp
Installe Citrix Virtual Apps. Si cette option est omise, Citrix Virtual Apps and Desktops est installé.
Exemples d’installation des composants principaux
La commande suivante installe un Delivery Controller, 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 Citrix Virtual Apps, 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
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 :
- VDA pour OS multi-session :
VDAServerSetup.exe
- VDA pour OS mono-session :
VDAWorkstationSetup.exe
- VDA pour services de base OS mono-session :
VDAWorkstationCoreSetup.exe
- VDA pour OS multi-session :
-
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 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
Pour exécuter le package téléchargé, exécutez son nom :
VDAServerSetup.exe
,VDAWorkstationSetup.exe
ouVDAWorkstationCoreSetup.exe
. Utilisez les options valides répertoriées dans cet article. -
Si vous connaissez le programme d’installation de la version complète du produit :
-
Exécutez le programme d’installation autonome
VDAServerSetup.exe
ouVDAWorkstationSetup.exe
comme s’il s’agissait de la commandeXenDesktopVdaSetup.exe
sauf pour le nom. -
Le programme d’installation
VDAWorkstationCoreSetup.exe
est 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 d’un VDA
Les options suivantes sont valides avec une ou plusieurs des commandes suivantes (programmes d’installation) : VDAServerSetup_xxxx.exe
, VDAWorkstationSetup_xxxx.exe
et VDAWorkstationCoreSetup_xxxx.exe
.
Pour de plus amples informations sur les options disponibles, consultez la section Installer des VDA.
-
/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 pour Windows, spécifiez
/components vda,plugins
.Si cette option 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_xxxx.exe
. Ce programme d’installation ne peut pas installer l’application Citrix Workspace. -
-
/controllers “controller [controller]”
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_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 supplémentaires 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 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.
-
/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 qui n’est pas gérée par MCS ne nécessite pas le composant Machine Identity Service. Les valeurs valides sont les suivantes :
OS multi-session OS mono-session Services de base d’OS mono-session Citrix Authentication Identity Assertion VDA Plug-in
Citrix Authentication Identity Assertion VDA Plug-in
Citrix Authentication Identity Assertion VDA Plug-in
Citrix Backup and Restore
Citrix Backup and Restore
Citrix Browser Content Redirection
Citrix Browser Content Redirection
Citrix Browser Content Redirection
Citrix Personalization for App-V - VDA
Citrix MCS IODriver
Citrix MCS IODriver
Citrix Telemetry Service
Citrix Personalization for App-V - VDA
Citrix Personalization for App-V - VDA
Citrix Universal Print Client
Citrix Profile Management
Citrix Profile Management
Citrix Vda Log Capture Service
Citrix Profile Management WMI Plug-in
Citrix Profile Management WMI Plug-in
CSE Component
Citrix Rendezvous V2
Citrix Rendezvous V2
Director VDA Plug-in
Citrix Supportability Tools
Citrix Supportability Tools
Machine Management Provider
Citrix Telemetry Service
Citrix Telemetry Service
VDA Monitor Plug-in
Citrix Universal Print Client
Citrix Universal Print Client
VDA WMI Proxy Plug-in
Citrix Vda Log Capture Service
Citrix Vda Log Capture Service
Citrix VDA Upgrade Agent
Citrix VDA Upgrade Agent
Citrix WEM Agent
Citrix WEM Agent
CSE Component
CSE Component
Director VDA Plug-in
Director VDA Plug-in
Machine Identity Service
Machine Identity Service
Machine Management Provider
Machine Management Provider
VDA Monitor Plug-in
User Personalization Layer
VDA WMI Proxy Plug-in
VDA Monitor Plug-in
VDA WMI Proxy Plug-in
L’exclusion de Citrix Profile Management de l’installation (
/exclude "Citrix Profile Management"
) 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.
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. Cette option peut être utile lorsque vous créez un déploiement Remote PC Access et souhaitez installer d’autres composants qui ne sont pas inclus par défaut. Les valeurs valides sont les suivantes :
OS multi-session OS mono-session Citrix Backup and Restore
Citrix Backup and Restore
Citrix MCS IODriver
Citrix MCS IODriver
Citrix Personalization for App-V - VDA
Citrix Personalization for App-V - VDA
Citrix Profile Management
Citrix Profile Management
Citrix Profile Management WMI Plug-in
Citrix Profile Management WMI Plug-in
Citrix Rendezvous V2
Citrix Rendezvous V2
Citrix Supportability Tools
Citrix Supportability Tools
Citrix VDA Upgrade Agent
Citrix VDA Upgrade Agent
Citrix WEM Agent
Citrix WEM Agent
Machine Identity Service
Machine Identity Service
User Personalization Layer
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 VM. Configure le VDA en tant qu’image à utiliser pour créer d’autres machines. Cette option est équivalente à
/mastermcsimage
.Cette option n’est pas valide lors de l’utilisation du programme d’installation
VDAWorkstationCoreSetup_xxxx.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) pour provisionner les machines virtuelles.
-
/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.
-
/nodesktopexperience
La fonctionnalité Enhanced Desktop Experience n’est plus disponible. Cette option (et ce paramètre de stratégie) est ignorée, si spécifiée.
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). Exclut l’installation de tout composant supplémentaire (consultez les listes de composants avec l’option
/exclude
et/includeadditional
).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./remotepc
n’est pas compatible avec l’option/servervdi
. -
/remove
Supprime les composants spécifiés avec l’option
/components
. -
/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é.
-
/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 une machine multi-session Windows prise en charge. Omettez cette option lors de l’installation d’un VDA pour OS multi-session sur une machine Windows multi-session.
Avant d’utiliser cette option, consultez la section Server VDI.
Utilisez cette option uniquement avec le programme d’installation du produit entier VDA.
-
/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 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.
-
/wem_add_firewall_rules
Ajoute des règles de pare-feu de l’agent WEM.
-
/wem_agent_cache_location
Autre emplacement de cache de l’agent WEM.
-
/wem_agent_port
Port utilisé par l’agent WEM pour communiquer avec le serveur d’infrastructure WEM.
-
/wem_cached_data_sync_port
Port utilisé par l’agent WEM pour synchroniser le cache avec le serveur d’infrastructure WEM.
-
/wem_cloud_connectors
Liste séparée par des virgules de Citrix Cloud Connector dans l’emplacement de ressources contenant le déploiement WEM.
-
/wem_server
Nom de domaine complet ou adresse IP du serveur d’infrastructure WEM.
-
/xendesktopcloud
Indique que le VDA est installé dans un déploiement de Citrix DaaS (Citrix Cloud).
Exemples d’installation d’un VDA
Installer un VDA avec le programme d’installation complet du produit :
La commande suivante installe un VDA pour OS mono-session et l’application Citrix Workspace à l’emplacement par défaut sur une VM. Ce VDA sera utilisé comme image et utilisera MCS pour provisionner les machines virtuelles. Lors de sa première exécution, le VDA s’enregistrera auprès du Controller sur le serveur appelé Contr-Main
dans le domaine mydomain
. Le VDA utilisera la couche de personnalisation de l’utilisateur et l’Assistance à distance Windows.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance
Installer un VDA pour OS mono-session avec le programme d’installation autonome VDAWorkstationCoreSetup :
La commande suivante installe un VDA Core Services sur un OS mono-session à utiliser dans un déploiement VDI ou Remote PC Access. L’application Citrix Workspace 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
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 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) -
/h
ou/help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports
Dépannage des VDA
-
Dans l’écran Studio d’un groupe de mise à disposition, l’entrée Version de VDA installée dans le panneau Détails peut ne pas être la version installée sur les machines. Les programmes et fonctionnalités Windows de la machine affichent la version actuelle du VDA.
-
Une fois qu’un VDA est installé, il ne peut pas fournir d’applications ou de bureau aux utilisateurs tant qu’il n’est pas enregistré auprès d’un Delivery Controller.
Pour en savoir plus sur les méthodes d’enregistrement du VDA et la résolution des problèmes d’enregistrement, consultez la section Enregistrement de VDA.
Options de ligne de commande pour l’installation d’un serveur d’impression universelle
L’option suivante est valide avec la commande XenDesktopPrintServerSetup.exe
.
- /enable_upsserver_port
Logiciel | Dossier | Nom du fichier |
---|---|---|
Microsoft Visual C++ 2017 Runtime, 32 et 64 bits | Support > VcRedist_2017 |
vcredist_x64.exe etvcredist_x86.exe
|
Citrix Diagnostic Facility | x64 > Virtual Desktop Components | cdf_x64.msi |
Composant serveur Serveur d’impression universelle | x64 > Universal Print Server | UpsServer_x64.msi |
Lorsque cette option n’est pas spécifiée, le programme d’installation affiche la page Pare-feu à partir de l’interface graphique. Sélectionnez Automatiquement pour que le programme d’installation ajoute automatiquement les règles du pare-feu Windows ou Manuellement pour permettre à l’administrateur de configurer manuellement le pare-feu.
Après avoir installé les logiciels sur vos serveurs d’impression, configurez le serveur d’impression universelle à l’aide des instructions de la section Provisionner les imprimantes.
Informations supplémentaires
Pour plus d’informations sur la façon dont Citrix présente le résultat de l’installation des composants, veuillez consulter la section Codes de retour de l’installation de Citrix.
Dans cet article
- Introduction
- Utiliser le programme d’installation du produit entier
- Options de ligne de commande pour l’installation des composants principaux
- Exemples d’installation des composants principaux
- Utiliser le programme d’installation de VDA autonome
- Options de ligne de commande pour l’installation d’un VDA
- Exemples d’installation d’un VDA
- Personnaliser un VDA
- Dépannage des VDA
- Options de ligne de commande pour l’installation d’un serveur d’impression universelle
- Informations supplémentaires