Installer à l'aide de la ligne de commande

Introduction

Utiliser le programme d'installation complet du produit

1. Téléchargez le package du produit depuis Citrix. Des informations d'identification de compte Citrix sont requises pour accéder au site de téléchargement.
2. Décompressez le fichier. Vous pouvez éventuellement graver un DVD à partir du fichier ISO.
3. Connectez-vous au serveur où vous installez les composants, en utilisant un compte administrateur local.
4. Insérez le DVD dans le lecteur ou montez le fichier ISO.
5. À partir du répertoire \x64\XenDesktop Setup sur le support, exécutez la commande appropriée.
   Pour installer les composants principaux : Exécutez XenDesktopServerSetup.exe, avec les options répertoriées dans 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 dossier x64 > StoreFront sur le support d'installation.
   Pour installer le serveur d'impression universel : Suivez les instructions dans Options de ligne de commande pour l'installation d'un serveur d'impression universel.
   Pour installer le service d'authentification fédérée : Citrix recommande d'utiliser l'interface graphique.
   Pour installer l'enregistrement de session : Suivez les instructions dans Enregistrement de session.

Options de ligne de commande pour l'installation des composants principaux

• /components composant ...
  Liste des composants à installer ou à supprimer, séparés par des virgules. Les valeurs valides sont :
  • CONTROLLER : Contrôleur
  • 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 la version 2003 et ultérieure, utilisez la commande d'installation StoreFront dédiée mentionnée dans Utiliser le programme d'installation complet du produit).
• /configure_firewall
  Ouvre tous les ports du pare-feu Windows utilisés par les composants en cours d'installation, 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.
• /désactiverlesmétriquesd'expérience
  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.
• /help ou /h
  Affiche l'aide de la commande.
• /ignore\_hw\_check\_failure
  Permet la poursuite de l'installation ou de la mise à niveau du Delivery Controller, même si les vérifications matérielles échouent (par exemple, en raison d'une RAM insuffisante). Pour plus d'informations, consultez Vérification matérielle.
• /ignore\_site\_test\_failure
  Valide uniquement lors de la mise à niveau du Controller. Généralement, toutes les défaillances des tests de site sont ignorées et la mise à niveau se poursuit. Si cette option est omise (ou définie sur false), toute défaillance des tests de site entraîne l'échec du programme d'installation, sans effectuer la mise à niveau. Par défaut = false
  Lors d'une mise à niveau, cette option est ignorée si une version non prise en charge de SQL Server est détectée. Pour plus de détails, consultez Vérification de la version de SQL Server.
• /installdir répertoire
  Répertoire vide existant où les composants seront installés. Par défaut = c:\Program Files\Citrix.
• /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
• /no_pending_reboot_check
  Lors de l'installation ou de la mise à niveau des composants principaux, empêche la vérification d'un redémarrage en attente d'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 des utilisateurs qui utilise l'Assistance à distance Windows.
• Pas de redémarrage
  Empêche un redémarrage après l'installation. (Pour la plupart des composants principaux, un redémarrage n'est pas activé par défaut.)
• Pas de reprise
  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 lors d'une installation automatisée.
• /NoSQL
  Empêche l'installation de Microsoft SQL Server Express sur le serveur où vous installez le Controller. Si cette option est omise, SQL Server Express est installé pour être utilisé comme 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 n'apparaît pendant l'installation. La seule preuve du processus d'installation se trouve dans le Gestionnaire des tâches de Windows. Si cette option est omise, l'interface graphique se lance.
• /supprimer
  Supprime les composants principaux spécifiés avec l'option /components.
• /toutsupprimer
  Supprime tous les composants principaux installés.
• /envoyermetriquesexperience
  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 /disableexperiencemetrics est spécifié), les analyses sont collectées localement, mais ne sont pas envoyées automatiquement.
• /tempdir répertoire
  Répertoire qui contient les fichiers temporaires pendant l'installation. 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

Utiliser un programme d’installation VDA autonome

1. Téléchargez le package approprié auprès de Citrix :
   • Agent de livraison virtuel de système d’exploitation multi-session : VDAServerSetup.exe
   • Agent de livraison virtuel de système d’exploitation mono-session : VDAWorkstationSetup.exe
   • Agent de livraison virtuel des services principaux du système d’exploitation mono-session : VDAWorkstationCoreSetup.exe
2. Extrayez d’abord les fichiers du package vers un répertoire existant, puis exécutez la commande d’installation, ou exécutez simplement le package.
   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
   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 cet article.

• Exécutez le programme d’installation autonome VDAServerSetup.exe ou VDAWorkstationSetup.exe comme s’il s’agissait de la commande XenDesktopVdaSetup.exe à tous égards, sauf son nom.
• L'installateur VDAWorkstationCoreSetup.exe est différent, car il prend en charge un sous-ensemble des options disponibles pour les autres installateurs.

Options de ligne de commande pour l'installation d'un VDA

• /components composant\[,composant\]
  Liste des 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 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 de l'installateur VDAWorkstationCoreSetup_xxxx.exe. Cet installateur ne peut pas installer l'application Citrix Workspace.
• /controllers "contrôleur \[ contrôleur\]"
  FQDN des contrôleurs séparés par des espaces avec lesquels le VDA peut communiquer, entre guillemets droits. Ne spécifiez pas les options /site_guid et /controllers simultanément.
• /désactiverlesmétriquesd'expérience
  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 utilisés par le transport adaptatif HDX, spécifiez l'option /enable_hdx_udp_ports, en plus de cette option /enable_hdx_ports.
• /enable\_hdx\_udp\_ports
  Ouvre les ports UDP dans le pare-feu Windows utilisés 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 des ports supplémentaires utilisés par le VDA, spécifiez l'option /enable_hdx_ports, en plus de cette 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_ports si 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 à distance dans l'Assistance à distance Windows pour une utilisation 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 à session unique) Permet un 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 :
  • /enablerestorecleanup indique à l'installateur de supprimer le point de restauration.
  • /enablerestore indique à l'installeur de conserver le point de restauration, même s'il n'a pas été utilisé.
  Pour plus de détails, consultez 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 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 qui n'est pas gérée par MCS ne nécessite pas le composant Machine Identity Service. Les valeurs valides sont les suivantes :

  SE multi-session	OS à session unique	Services principaux du SE à session unique
  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 le dépannage des VDA avec Citrix Director. 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 des profils utilisateur 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 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 de l'installateur VDAWorkstationCoreSetup.exe. Cet installateur 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. Cette option peut être utile lorsque vous créez un déploiement d'accès PC distant et que vous souhaitez installer d'autres composants qui ne sont pas inclus par défaut. Les valeurs valides sont les suivantes :

  SE multi-session	OS à session unique
  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 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. L'installeur ne le crée pas. Par défaut = « %TEMP%\Citrix\XenDesktop Installer »
  Cette option n'est pas disponible dans l'interface graphique.
• /image-maître
  Valide uniquement lors de l'installation d'un VDA sur une VM. Configure le VDA comme une image à utiliser pour créer d'autres machines. Cette option est équivalente à /mastermcsimage.
  Cette option n'est pas valide lors de l'utilisation de l'installateur VDAWorkstationCoreSetup_xxxx.exe.
• /image-maître-mcs
  Spécifie que cette machine sera utilisée comme image avec Machine Creation Services. Cette option est équivalente à /masterimage.
• /imagePVSmaître
  Spécifie 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 des VM.
• /no\_mediafoundation\_ack
  Reconnaît que Microsoft Media Foundation n'est pas installé et que plusieurs fonctionnalités multimédia HDX™ ne seront pas installées et ne fonctionneront 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.
• /sansbureauexpérience
  La fonctionnalité Expérience de bureau améliorée n'est plus disponible. Cette option (et le 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 également contrôlée par le paramètre de stratégie Citrix Expérience de bureau améliorée.
• Pas de redémarrage
  Empêche un redémarrage après l'installation. Le VDA ne peut pas être utilisé avant un redémarrage.
• Pas de reprise
  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 lors d'une installation automatisée.
• /portnumber numéro_de_port
  Valide uniquement lorsque l'option /reconfig est 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 la fonctionnalité, consultez Protocole Rendezvous.
  • Format de l'adresse du proxy : http://<url-or-ip>:<port>
  • Format du fichier PAC : http://<url-or-ip>:<port>/<path>/<filename>.pac
• /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.
• /reconfigurer
  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 du VDA se lance.
• /pcdistant
  Valide uniquement pour les déploiements d'accès PC distant (OS mono-session) ou les connexions intermédiées (OS multi-session). Exclut l'installation de tout composant supplémentaire (voir les listes de composants avec les options /exclude et /includeadditional).
  Cette option n'est pas valide lors de l'utilisation de l'installeur VDAWorkstationCoreSetup.exe. Cet installeur exclut automatiquement l'installation de ces composants.
  /remotepc n'est pas compatible avec l'option /servervdi.
• /supprimer
  Supprime les composants spécifiés avec l'option /components.
• /remove_appdisk_ack
  Autorise l'installeur VDA à désinstaller le plug-in VDA AppDisks™ s'il est installé.
• /remove_pvd_ack
  Autorise l'installeur VDA à désinstaller Personal vDisk s'il est installé.
• /toutsupprimer
  Supprime le VDA. Il ne supprime pas l'application Citrix Workspace (si elle est installée).
• /envoyermetriquesexperience
  Envoie automatiquement les analyses collectées lors de l'installation, de la mise à niveau ou de la suppression à Citrix. Si cette option est omise (ou si l'option /disableexperiencemetrics est spécifiée), les analyses sont collectées localement, mais ne sont pas envoyées automatiquement.
• /serveurvdi
  Installe un VDA pour OS mono-session sur une machine Windows multi-session 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 VDI de serveur.
  Utilisez cette option uniquement avec le programme d'installation du VDA complet.
• /site\_guid identifiant
  Identificateur global unique de l'unité d'organisation (OU) 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 les options /site_guid et /controllers simultanément.
• /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.
• /machinevirtuelle
  Valide uniquement lors de l'installation d'un VDA sur une machine virtuelle. Annule la détection par l'installateur d'une machine physique, lorsque les informations BIOS transmises aux machines virtuelles les font apparaître comme des machines physiques.
  Cette option n'est pas disponible dans l'interface graphique.
• /wem_add_firewall_rules
  Ajoute des règles de pare-feu pour l'agent WEM.
• /wem_agent_cache_location
  Emplacement alternatif du 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 des Citrix Cloud™ Connectors dans l'emplacement des ressources contenant le déploiement WEM.
• /wem_server
  Nom de domaine complet (FQDN) ou adresse IP du serveur d'infrastructure WEM.
• /xendesktopnuage
  Indique que le VDA est installé dans un déploiement Citrix DaaS™ (Citrix Cloud).

Exemples d'installation d'un VDA

Personnaliser un VDA

• /reconfigure (requis lors de la personnalisation d'un VDA)
• /h ou /help
• /quiet
• /noreboot
• /controllers
• /portnumber port
• /enable_hdx_ports

Dépanner les VDA

• Dans l'affichage Studio d'un groupe de mise à disposition, l'entrée Version du VDA installé dans le volet Détails peut ne pas correspondre à la version installée sur les machines. L'affichage Programmes et fonctionnalités de Windows de la machine indique la version réelle du VDA.
• Une fois qu'un VDA est installé, il ne peut pas fournir d'applications ou de bureaux aux utilisateurs tant qu'il ne s'est pas enregistré auprès d'un Delivery Controller.
  Pour en savoir plus sur les méthodes d'enregistrement de VDA et sur la façon de résoudre les problèmes d'enregistrement, consultez Enregistrement de VDA.

Options de ligne de commande pour l'installation d'un Universal Print Server

• /enable_upsserver_port

Plus d'informations