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.

Si vous tentez d’installer (ou de mettre à niveau) un VDA Windows sur un système d’exploitation non pris en charge par cette version du produit, un message vous renvoie vers des informations décrivant vos options. Ces informations sont également disponibles dans 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 :

  1. 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.
  2. Décompressez le fichier. Éventuellement, gravez un DVD du fichier ISO.
  3. Ouvrez une session sur le serveur sur lequel vous installez les composants, à l’aide d’un compte d’administrateur local.
  4. Insérez le DVD dans le lecteur ou montez le fichier ISO.
  5. À 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 la section Options de ligne de commande pour l’installation d’un VDA.

Pour installer le serveur d’impression universelle : suivez les instructions dans 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 section Service de réinitialisation en libre-service des mots de passe.

Pour installer l’enregistrement de session : suivez les instructions de la section Enregistrement de session.

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.

  1. Téléchargez le pack approprié auprès de Citrix :
    • Server OS Virtual Delivery Agent : VDAServerSetup.exe
    • Desktop OS Virtual Delivery Agent : VDAWorkstationSetup.exe
    • Desktop OS Core Services Virtual Delivery Agent : VDAWorkstationCoreSetup.exe
  2. 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 absolu, par exemple .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. Le répertoire doit exister. Sinon, l’extraction échoue.
      • Puis dans une commande séparée, exécutez XenDesktopVdaSetup.exe à partir du répertoire contenant le contenu extrait (dans l’exemple ci-dessus, 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 pack 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.exe ou VDAWorkstationSetup.exe comme s’il s’agissait de la commande XenDesktopVdaSetup.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 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
    • STOREFRONT : StoreFront

    Si cette option est omise, tous les composants sont installés (ou supprimés, si l’option /remove est également spécifiée).

  • /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. Les valeurs autorisées sont :

    • “Stockage du cache d’hôte local (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.

  • /help ou/h

    Affiche la commande d’aide.

  • /ignore_site_test_failure

    Valable uniquement pendant la mise à niveau du Controller. 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

  • /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 principaux composants 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 Controller Citrix Virtual Apps and Desktops, 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

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.

Pour de plus amples informations sur les options disponibles, consultez la section Installer des VDA.

  • /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. Personal vDisk est obsolète.

    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 : 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.exe. Ce programme d’installation ne peut pas installer l’application Citrix Workspace.

  • /controllers “contrôleur [contrôleur]“

    Noms de domaines complets (FQDN) séparés par des virgules des Controller avec lesquels le VDA peut communiquer, entourés de guillemets. 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_ports

    Ouvre les ports du pare-feu Windows requis par le Controller 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 que le transport adaptatif HDX utilise pour communiquer avec le Controller, 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, 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 que le VDA utilise pour communiquer avec le Controller et les fonctionnalités activées, 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 (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 “composant”[,”composant”]

    Empêche l’installation d’un ou de plusieurs composants facultatifs séparés par des virgules, entourés de guillemets. 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 autorisées sont :

    • AppDisk VDA Plug-in
    • Personal vDisk
    • Machine Identity Service
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Client d’impression universelle Citrix
    • Citrix Telemetry Service
    • Citrix Personalization pour AppV : VDA
    • Outils de prise en charge Citrix
    • Agent Smart Tools
    • Citrix Files pour Windows

    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.

    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 /includeeadditional avec le même nom de composant supplémentaire, 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.

  • /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.

  • /includeadditional

    Inclut l’installation d’un ou de plusieurs composants facultatifs séparés par des virgules, entourés de guillemets. Cette option peut être utile lorsque vous créez un déploiement Remote PC Access et souhaitez installer des composants supplémentaires qui ne sont pas inclus par défaut. Les valeurs autorisées sont :

    • Personal vDisk
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Client d’impression universelle Citrix
    • Citrix Telemetry Service
    • Citrix Personalization pour AppV : VDA
    • Outils de prise en charge Citrix
    • Agent Smart Tools
    • Citrix Files pour Windows

    Si vous spécifiez à la fois /exclude et /includeeadditional avec le même nom de composant supplémentaire, ce composant est exclus de l’installation.

  • /installdir directory

    Répertoire vide existant où les composants seront installés. Valeur par défaut : c:\Program Files\Citrix.

  • /install_mcsio_driver

    Active le cache en écriture des E/S de MCS pour optimiser le stockage.

  • /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 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 principale avec Machine Creation Services pour provisionner les machines virtuelles. Cette option est équivalente à /masterimage.

  • /masterpvsimage

    Indique que cette machine sera utilisée comme image principale 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

    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 obtenir davantage d’informations, veuillez consulter l’article CTX125874.

  • /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 (OS de bureau) ou les connexions négociées (OS de serveur). Exclut l’installation des composants suivants sur un OS de bureau :

    • Citrix Personalization pour AppV
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Machine Identity Service
    • Personal vDisk
    • Outils de prise en charge Citrix
    • Citrix Files pour Windows

    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.

    Cette option doit uniquement être utilisée 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 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.

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 de bureau et l’application Citrix Workspace à l’emplacement par défaut sur une VM. Ce VDA sera utilisé comme image principale 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 mondomaine. Le VDA utilisera la fonctionnalité d’optimisation et Windows Remote Assistance.

\\x64\\XenDesktop Setup\\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable\_hdx\_ports /optimize /mastermcsimage /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. 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

Installer le serveur d’impression universelle

Sur chacun de vos serveurs d’impression, installez les logiciels suivants, dans l’ordre indiqué. Ce logiciel est disponible dans les dossiers spécifiés sur le support d’installation du produit.

Logiciel Dossier Nom du fichier
Microsoft Visual C++ 2013 Runtime, 32 et 64 bits Support > VcRedist_2013_RTM vcredist_x64.exe et vcredist_x86.exe
Microsoft Visual C++ 2015 Runtime, 32 et 64 bits Support > VcRedist_2015 vc_redist.x64.exe et vc_redist.x64.exe
Citrix Diagnostic Facility x64 > Virtual Desktop Components cdf_x64.msi
Composant serveur Serveur d’impression universelle x64 > Universal Print Server UpsServer_x64.msi

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.