Citrix DaaS

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

Introduction

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

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.

Installer un VDA à partir de la ligne de commande

Pour installer un VDA (et voir le progrès d’exécution des commandes et les valeurs de retour), vous devez disposer d’autorisations d’administrateur élevées 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 supérieur gauche, sélectionnez Mes services > DaaS.
  3. Sur le côté supérieur droit, cliquez sur Téléchargements et sélectionnez Télécharger VDA. 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 VDA pour OS multi-session, exécutez VDAServerSetup.exe

    • Pour le VDA pour OS mono-session, exécutez VDAWorkstationSetup.exe

    • Pour le VDA pour services de base OS mono-session, 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’extrait é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

Options de ligne de commande pour installer un VDA

Les options suivantes sont valides avec une ou plusieurs des commandes : VDAServerSetup.exe, VDAWorkstationSetup.exe et VDAWorkstationCoreSetup.exe.

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

    Si l’option plugins 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.

  • /controllerscontroller [*controller*]…”

    Noms de domaines complets (FQDN) séparés par des espaces et entourés de guillemets droits des Citrix Cloud Connector avec lesquels le VDA peut communiquer. 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 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 de l’Assistance à distance Windows pour l’utiliser avec les fonctions Surveiller. 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.

  • /excludecomponent”[,”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 gérée par MCS nécessite le composant Machine Identity Service. Les valeurs autorisées sont :

    • Machine Identity Service
    • Citrix Profile Management
    • Plug-in WMI de Citrix Profile Management
    • Citrix Personalization pour AppV - VDA
    • Outils de prise en charge Citrix
    • Pilote E/S de MCS Citrix
    • Agent de mise à niveau de Citrix VDA
    • Citrix Rendezvous V2

    L’exclusion de Citrix Profile Management de l’installation (/exclude "Citrix Profile Management") affecte la surveillance et le dépannage des VDA à partir de l’onglet Surveiller. 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 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 /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.

  • /includeadditionalcomponent”[,”component”] …

    Inclut l’installation d’un ou de plusieurs composants facultatifs séparés par des virgules et entourés de guillemets droits. Les noms des composants sont sensibles à la casse.

    Cette option peut être utile lorsque vous créez un déploiement Remote PC Access et souhaitez installer des composants qui ne sont pas inclus par défaut. Les valeurs autorisées sont :

    • Citrix Profile Management
    • Plug-in WMI de Citrix Profile Management
    • Citrix Personalization pour AppV - VDA
    • Outils de prise en charge Citrix
    • Pilote E/S de MCS Citrix
    • Agent de mise à niveau de Citrix VDA
    • Citrix Rendezvous V2
    • Couche de personnalisation de l’utilisateur
    • Outil d’enregistrement de VDA Citrix WebSocket

    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 machine virtuelle. Définit le VDA comme image. 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 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).

  • /no_mediafoundation_ack

    Reconnaît que Microsoft Media Foundation n’est pas installé, et que plusieurs fonctionnalités multimédias de HDX ne sont pas installées et ne fonctionnent 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 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.

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

    Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe. Ce programme d’installation exclut automatiquement l’installation de ces composants.

  • /remove_appdisk_ack

    Autorise le programme d’installation du VDA à désinstaller le plug-in AppDisks VDA s’il est installé.

  • /remove_pvd_ack

    Autorise le programme d’installation du VDA à désinstaller Personal vDisk s’il est installé.

  • /remove

    Supprime les composants spécifiés avec l’option /components.

  • /removeall

    Supprime le VDA. 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 un serveur Windows pris en charge. Évitez cette option lors de l’installation d’un VDA multi-session sur un serveur Windows. Avant d’utiliser cette option, consultez la section Server VDI.

  • /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 machine virtuelle. Remplace la détection par le programme d’installation d’une machine physique, où les informations du BIOS transmises aux machine virtuelle les font passer pour des machines physiques.

    Cette option n’est pas disponible dans l’interface graphique.

  • /xendesktopcloud

    Indique que le VDA est installé dans un déploiement de Citrix DaaS (Citrix Cloud).

Exemples : Installer un VDA

  • Installer un VDA sur un OS multi-session. La commande suivante installe un VDA sur un OS multi-session.

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

    Le VDA sera utilisé comme image.

  • Installer un VDA d’OS multi-session ou un VDA d’OS mono-session. La commande suivante installe un VDA d’OS multi-session ou un VDA d’OS mono-session.

    VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot

    Séparez le nom de domaine complet de chaque Delivery Controller par une virgule. Notez que XXXX représente la version du VDA.

  • Installer un VDA Core Services sur un OS mono-session. La commande suivante installe un VDA Core Services sur un OS mono-session à utiliser dans un déploiement VDA ou Remote PC Access.

    VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

    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 sont automatiquement ouverts. L’administrateur gère les redémarrages.

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

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