Installer des VDA à l’aide de la ligne de commande

Cet article explique comment installer et personnaliser des VDA sur des machines avec systèmes d’exploitation Windows.

Important :

Cet article explique comment émettre des commandes d’installation de VDA. Avant de commencer l’installation, consultez la section Installer des VDA pour en savoir plus sur l’installation, les programmes d’installation et les informations que vous spécifiez pendant l’installation.

Citrix fournit des exemples de scripts pour installer, supprimer ou mettre à niveau des VDA. Pour de plus amples informations, consultez Installer les VDA à l’aide de scripts.

Installer un VDA

Pour installer un VDA (et voir le progrès d’exécution des commandes et les valeurs de retour), vous devez disposer de privilèges d’administrateur élevés ou utiliser Exécuter en tant qu’administrateur.

  1. Sur la machine sur laquelle vous installez le VDA, connectez-vous à Citrix Cloud.
  2. Dans le menu en haut à gauche, sélectionnez Mes services > Virtual Apps and Desktops.
  3. Sur le côté supérieur droit, cliquez sur Téléchargements et sélectionnez Télécharger VDA depuis le menu déroulant. Vous serez redirigé vers la page de téléchargement du VDA. Recherchez le programme d’installation du VDA que vous souhaitez et cliquez sur Télécharger fichier.
  4. Une fois le téléchargement terminé, exécutez le programme d’installation. Utilisez les options décrites dans cet article.

    • Pour le composant Server OS Virtual Delivery Agent, exécutez VDAServerSetup.exe

    • Pour le composant Desktop OS Virtual Delivery Agent, exécutez VDAWorkstationSetup.exe

    • Pour le composant Desktop OS Core Services Virtual Delivery Agent, exécutez VDAWorkstationCoreSetup.exe

Pour extraire les fichiers avant de les installer, utilisez /extract avec le chemin d’accès absolu, par exemple : .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. (Le répertoire doit exister. Sinon, l’extraction échoue.) Ensuite, dans une commande séparée, exécutez VDAWorkstationCoreSetup.exe à partir du répertoire contenant le contenu extrait (dans l’exemple ci-dessus, CitrixVDAInstallMedia). Utilisez les options valides répertoriées dans cet article.

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.

  • /baseimage

    Cette technologie est obsolète. 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.

    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, spécifiez /components vda,plugins.

    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 Citrix Cloud Connector 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 Cloud Connector 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 les fonctions de surveillance du composant Director de Citrix Cloud. 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 le composant Director de Citrix Cloud. 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, 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 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 n’est pas installé.

  • /installdir <répertoire>

    Répertoire vide existant où les composants seront installés. Valeur 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. 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.

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

    • 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 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 répertoire

    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 : Installer un VDA

La commande suivante installe un VDA sur un OS de serveur. Le VDA sera utilisé comme image principale.

VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimge

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 Cloud Connector 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 à l’aide de la ligne de commande

Une fois que vous avez installé un VDA, vous pouvez personnaliser plusieurs paramètres. Exécutez XenDesktopVDASetup.exe, en utilisant une ou plusieurs des options suivantes.

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

Autres ressources

Créer des catalogues de machines

Pour passer en revue l’ensemble du processus de configuration, consultez la section Installer et configurer.