Installer à l’aide de la ligne de commande

Important :

• Si vous effectuez une mise à niveau et que votre version actuelle utilise ou a le logiciel Personal vDisk ou AppDisks installé, consultez Suppression de PvD, AppDisks et des hôtes non pris en charge.

• Citrix collecte les données de licence de base nécessaires à ses intérêts légitimes, y compris la conformité des licences. Pour plus d’informations, consultez Données de licence Citrix.

Introduction

Cet article s’applique à l’installation de composants sur des machines dotées de systèmes d’exploitation Windows. Pour plus d’informations sur les VDA pour les systèmes d’exploitation Linux, consultez Agents de livraison virtuelle Linux.

Cet article décrit comment émettre des commandes d’installation de produit. Avant de commencer toute installation, consultez Préparer l’installation. Cet article inclut des descriptions des programmes d’installation disponibles.

Pour afficher la progression de l’exécution des commandes et les valeurs de retour, vous devez être l’administrateur d’origine ou utiliser Exécuter en tant qu’administrateur. Pour plus d’informations, consultez la documentation des commandes Microsoft.

En complément de l’utilisation directe des commandes d’installation, des exemples de scripts sont fournis sur l’ISO du produit qui installent, mettent à niveau ou suppriment des VDA sur des machines dans Active Directory. Pour plus de détails, consultez Installer des VDA à l’aide de scripts.

Si vous tentez d’installer ou de mettre à niveau sur une version de système d’exploitation Windows qui n’est pas prise en charge pour cette version de Citrix Virtual Apps and Desktops, un message vous guidera vers des informations sur vos options. Consultez Systèmes d’exploitation antérieurs.

Pour plus d’informations sur la façon dont Citrix signale les résultats des installations de composants, consultez Codes de retour d’installation Citrix.

Utiliser le programme d’installation complet du produit

Pour accéder à l’interface de ligne de commande du 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 du fichier ISO.
3. Connectez-vous au serveur où vous installez les composants, à l’aide d’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 Session Recording : Suivez les instructions dans Session Recording.

   Pour installer Workspace Environment Management : Suivez les instructions dans Workspace Environment Management.

   Pour installer Secure Private Access : Exécutez XenDesktopSPASetup.exe dans le dossier d’installation x64 > XenDesktop sur le support d’installation. Suivez les instructions dans Options de ligne de commande pour l’installation d’un Secure Private Access.

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

Les options de paramètre suivantes sont valides lors de l’installation des composants principaux avec la commande XenDesktopServerSetup.exe. Pour plus de détails sur les options, consultez Installer les composants principaux.

Remarque :

• N’utilisez pas /exclude lors de l’utilisation des options de ligne de commande pour l’installation des composants principaux.
• Si vous mettez à niveau un composant à l’aide de /components, d’autres composants peuvent également être mis à niveau. Cela permet d’éviter d’éventuels problèmes de compatibilité entre les différents composants.
• Si vous souhaitez mettre à niveau un seul composant, utilisez le programme d’installation individuel de ce composant. Consultez Mettre à niveau un déploiement.

• /ceipoptin ceipoptin [,ceipoptin] etc.

  Permet la collecte des données Call Home et des données du programme d’amélioration de l’expérience client (CEIP). Les valeurs valides sont :

  • DIAGNOSTIC : Choisissez cette valeur pour permettre à Citrix Licensing de collecter les données Call Home.
  • ANONYMOUS : Choisissez cette valeur pour permettre à Citrix Licensing de collecter des données CEIP non identifiées (qui n’identifient pas les utilisateurs).
  • NONE : Choisissez cette valeur pour désactiver la collecte des données CEIP par Citrix Licensing.

  Pour plus d’informations sur la collecte des données Call Home, consultez Citrix Licensing Call Home.

  Pour plus de détails sur la collecte des données CEIP, consultez Citrix Licensing Customer Experience Improvement Program.

  Pour plus de détails sur les données CEIP, consultez Citrix Licensing CEIP data elements.

  Pour plus de détails sur les données de licence du serveur de licences, consultez Citrix Licensing Data.

• /components component [,component] etc.

  Liste des composants à installer ou à supprimer, séparés par des virgules. Les valeurs valides sont :

  • CONTROLLER : Contrôleur
  • DESKTOPSTUDIO : Studio
  • WEBSTUDIO: Web Studio
  • DESKTOPDIRECTOR: Director
  • LICENSESERVER: Serveur de licences Citrix
  • SECUREPRIVATEACCESS: Secure Private Access

  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étriquesdexperience

  Empêche le téléchargement automatique des analyses collectées lors de l’installation, de la mise à niveau ou de la suppression vers Citrix.

• /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, les échecs des tests de site sont ignorés et la mise à niveau se poursuit. S’il est omis (ou défini sur false), tout échec de test de site entraîne l’échec de l’installateur, sans effectuer la mise à niveau. 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 de détails, consultez Vérification de la version de SQL Server.

• /répertoireinstallation répertoire

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

• /cheminjournal chemin

  Emplacement du fichier journal. Le dossier spécifié doit exister. L’installateur ne le crée pas. Par défaut = TEMP%\Citrix\XenDesktop Installer

• /no_remote_assistance

  Valide uniquement lors de l’installation du Director. Désactive la fonctionnalité d’observation des utilisateurs qui utilise l’Assistance à distance Windows.

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

• /sansreprise

  Par défaut, lorsqu’un redémarrage de la machine est nécessaire pendant une installation, l’installateur reprend automatiquement après la fin du redémarrage. Pour annuler la valeur par défaut, spécifiez /noresume. Cela peut être utile si vous devez remonter le média ou si vous souhaitez capturer des informations pendant une installation automatisée.

• /sanssql

  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 de site.

  Cette option n’affecte pas l’installation de SQL Server Express LocalDB utilisée 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.

• /SKIPHDXDRIVERCHECK

  Ignore la vérification des pilotes HDX™ par le méta-installateur VDA.

• /envoyermétriquesd’expérience

  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.

• /répertoiretemporaire 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

La commande suivante installe un Delivery Controller™, Studio, Citrix Licensing et SQL Server Express sur un serveur. Les ports de pare-feu requis pour les communications des 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 la communication des composants sont ouverts automatiquement.

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall

La commande suivante installe un Delivery Controller, Secure Private Access et SQL Server Express sur un serveur. Les ports de pare-feu requis pour la communication des composants sont ouverts automatiquement.

\x64\XenDesktop Setup XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall

Utiliser un programme d’installation VDA autonome

Des informations d’identification de compte Citrix sont requises pour accéder au site de téléchargement. Vous devez disposer de privilèges administratifs élevés avant de démarrer l’installation, ou utiliser Exécuter en tant qu’administrateur.

1. Téléchargez le package approprié auprès de Citrix :
   • Agent de livraison virtuel de système d’exploitation multi-session : VDAServerSetup_xxxx.exe
   • Agent de livraison virtuel de système d’exploitation mono-session : VDAWorkstationSetup_xxxx.exe
   • Agent de livraison virtuel de services de base de système d’exploitation mono-session : VDAWorkstationCoreSetup_xxxx.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 C:\YourExtractFolder\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.

Si vous êtes familiarisé avec le programme d’installation complet du produit :

• Exécutez le programme d’installation autonome VDAServerSetup.exe ou VDAWorkstationSetup.exe comme s’il s’agissait de la commande XenDesktopVdaSetup.exe pour tout, sauf son nom.

• Le programme d’installation VDAWorkstationCoreSetup.exe est différent, car il prend en charge un sous-ensemble des options disponibles pour 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 (programmes d’installation) suivantes : VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe et VDAWorkstationCoreSetup_xxxx.exe.

Pour plus de détails sur les options, consultez Installer les VDA.

• /components composant[,composant]

  Liste de composants séparés par des virgules à installer ou à supprimer. Les valeurs valides sont :

  • VDA : Agent de livraison virtuel
  • PLUGINS : application Citrix Workspace™ pour Windows

  Pour installer le VDA et l’application Citrix Workspace pour Windows, spécifiez /components vda,plugins ou ne spécifiez aucun composant. Si aucun composant n’est spécifié, seul le VDA sera installé par défaut.

  Pour installer uniquement le VDA et exclure l’installation de l’application Citrix Workspace, spécifiez /components vda.

  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]”

  Noms de domaine complets (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 les 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_hdx_tls_dtls

  Ouvre les ports TCP et UDP 443 pour HDX Direct V1.

• /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 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’installateur 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 d’installation ou de mise à niveau.

• /enable_ss_ports

  Ouvre les ports dans le Pare-feu Windows qui sont nécessaires au 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 non gérée par MCS ne nécessite pas le composant Service d’identité de machine. Les valeurs valides sont les suivantes :

  SE multi-session	SE à session unique	Services principaux du SE à session unique
  Citrix App Protection Component	Citrix App Protection Component	Citrix App Protection Component
  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 HyperV Filter Driver	Citrix HyperV Filter Driver
  Citrix MCS IODriver	Citrix MCS IODriver
  Citrix Personalization for App-V - VDA	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 Telemetry Service	Citrix Telemetry Service	Citrix Telemetry Service
  Citrix Universal Print Client	Citrix Universal Print Client	Citrix Universal Print Client
  Citrix Vda Log Capture Service	Citrix Vda Log Capture Service	Citrix Vda Log Capture Service
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  CSE Component	CSE Component	CSE Component
  Director VDA Plug-in	Director VDA Plug-in	Director VDA Plug-in
  Machine Identity Service	Machine Identity Service
  Machine Management Provider	Machine Management Provider	Machine Management Provider
  	User Personalization Layer
  VDA Monitor Plug-in	VDA Monitor Plug-in	VDA Monitor Plug-in
  VDA WMI Proxy Plug-in	VDA WMI Proxy 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 des 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 du programme d’installation VDAWorkstationCoreSetup.exe. Ce programme d’installation 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	SE 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 VDA Upgrade Agent	Citrix VDA Upgrade Agent
  Citrix Web Socket Vda Registration Tool	Citrix Web Socket Vda Registration Tool
  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’installateur 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’installeur 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.

• image maître PVS

  Spécifie que cette machine sera utilisée comme image avec Citrix Provisioning™ ou un outil de provisionnement tiers (tel que Microsoft System Center Configuration Manager) pour provisionner des VM.

• jeton websocket WebSocketToken

  Crée un VDA Web Socket. Le WebSocketToken est pour le jeton requis.

• /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 se termine car les préconditions ne sont pas remplies. La plupart des éditions de Windows prises en charge sont livrées avec Media Foundation déjà installé, à l’exception des éditions N. Si vous activez manuellement les fonctionnalités Windows > Fonctionnalités multimédia, la clé de registre recherchée par le programme d’installation Citrix Meta Installer peut ne pas avoir de valeur définie. Vérifiez la clé de registre SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion avant de démarrer le processus d’installation pour confirmer que la valeur existe et n’est pas vide.

• sans expérience de bureau

  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.

• sans redémarrage

  Empêche un redémarrage après l’installation. Le VDA ne peut pas être utilisé avant un redémarrage.

• /sansreprise

  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 le comportement 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.

• /machinephysique

  Utilisez cet argument avec /remotepc pour l’installation RemotePC. Sinon, le VDA pourrait ne pas se comporter comme prévu dans certains scénarios utilisateur.

• /numérodeport 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”

  Si vous prévoyez d’utiliser le protocole Rendezvous V2 avec un service tel que Gateway Service dans votre environnement et que vous disposez d’un proxy non transparent dans votre réseau pour les connexions sortantes, spécifiez le proxy ici. Seuls les proxys HTTP sont pris en charge. L’adresse ou le chemin du fichier PAC du proxy à utiliser avec le protocole Rendezvous. Pour plus de détails sur les fonctionnalités, 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.

• /pc-distant

  Valide uniquement pour les déploiements d’accès PC distant (OS à session unique) 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é.

• /tout-supprimer

  Supprime le VDA. Il ne supprime pas l’application Citrix Workspace (si elle est installée).

• /REMOVEALLWITHCWA

  Supprime CWA avec le VDA.

• /envoyer-les-métriques-d’expérience

  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.

• VDI de serveur

  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 VDA complet.

• GUID de site guid

  Identificateur global unique de l’unité d’organisation (UO) 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 contenir les fichiers temporaires pendant l’installation. Par défaut = c:\Windows\Temp.

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

• machine virtuelle

  Valide uniquement lors de l’installation d’un VDA sur une VM. Remplace la détection par le programme d’installation d’une machine physique, lorsque les informations du BIOS transmises aux VM les font apparaître comme des machines physiques.

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

• cloud XenDesktop

  Indique que le VDA est installé dans un déploiement 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 à session unique 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 VM. Le VDA s’enregistrera initialement auprès du Controller sur le serveur nommé Contr-Main dans le domaine mydomain. Le VDA utilisera la couche de personnalisation 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 à session unique avec le programme d’installation autonome VDAWorkstationCoreSetup :

La commande suivante installe un VDA de services de base sur un OS à session unique pour une utilisation dans un déploiement d’accès PC distant ou VDI. L’application Citrix Workspace et les autres services non essentiels ne sont pas installés. L’adresse d’un Controller est spécifiée, et les ports du service Pare-feu Windows seront ouverts automatiquement. L’administrateur gérera les redémarrages.

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

Personnaliser un VDA

Après avoir installé un VDA, vous pouvez personnaliser plusieurs paramètres. À partir du répertoire \x64\XenDesktop Setup sur le support du produit, exécutez XenDesktopVdaSetup.exe, en utilisant une ou plusieurs des options suivantes, qui sont décrites dans Options de ligne de commande pour l’installation d’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 un VDA 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

L’option suivante est valide avec la commande XenDesktopPrintServerSetup.exe.

• /enable_upsserver_port

Lorsque cette option n’est pas spécifiée, le programme d’installation affiche la page Pare-feu de l’interface graphique. Sélectionnez Automatiquement pour que le programme d’installation ajoute automatiquement les règles de pare-feu Windows, ou Manuellement pour permettre à l’administrateur de configurer manuellement le pare-feu.

Après avoir installé le logiciel sur vos serveurs d’impression, configurez le Universal Print Server en suivant les instructions de Provisionner les imprimantes.

Options de ligne de commande pour l’installation d’un Secure Private Access

Les options suivantes sont valides avec :

1. Programme d’installation CVAD : XenDesktopSPASetup.exe
2. Programme d’installation SPA sur site : SecurePrivateAccessSetup_XXXX.exe

• /enable_spa_ports

  Ouvre les ports dans le pare-feu Windows requis par Secure Private Access, 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.

• sans SQL

  Empêche l’installation de Microsoft SQL Server Express sur le serveur où vous installez Secure Private Access. Si cette option est omise, SQL Server Express est installé pour être utilisé comme base de données du site.

• /help ou /h ou /?

  Affiche l’aide de la commande

• sans redémarrage

  Empêche un redémarrage après l’installation. Secure Private Access ne peut pas être utilisé avant un redémarrage.

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

• supprimer

  Supprime Secure Private Access.

Pour plus de détails sur les options, consultez Programme d’installation de Secure Private Access.

Plus d’informations

Pour plus d’informations sur la façon dont Citrix signale le résultat des installations de composants, consultez Codes de retour d’installation Citrix.