Installer à l’aide de la ligne de commande
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 la documentation Linux Virtual Delivery Agent.
Important :
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 machines VDA dans Active Directory. Pour plus de détails, consultez Installer des VDA à l’aide de scripts.
Utiliser le programme d’installation complet du produit
Pour accéder à l’interface de ligne de commande du programme d’installation complet du produit :
- 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.
- Décompressez le fichier. Vous pouvez éventuellement graver un DVD du fichier ISO.
- Connectez-vous au serveur sur lequel vous installez les composants, à l’aide d’un compte administrateur local.
- Insérez le DVD dans le lecteur ou montez le fichier ISO.
- À partir du répertoire
\x64\XenDesktop Setupsur le support, exécutez la commande appropriée.
Pour installer les composants principaux
Exécutez la commande 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 la commande XenDesktopVDASetup.exe avec les options répertoriées dans Options de ligne de commande pour l’installation d’un VDA.
Pour installer le serveur d’impression universel
Suivez les instructions figurant dans Installer le serveur d’impression universel à l’aide de la ligne de commande.
Pour installer le service d’authentification fédérée
Citrix recommande d’utiliser l’interface graphique.
Pour installer le service de réinitialisation de mot de passe en libre-service
Suivez les instructions figurant dans la documentation du service de réinitialisation de mot de passe en libre-service.
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 d’administrateur élevés avant de démarrer l’installation ou utiliser Exécuter en tant qu’administrateur.
- Téléchargez le package approprié depuis Citrix :
| Nom du composant sur la page de téléchargement | Nom du fichier d’installation |
|---|---|
| Agent de livraison virtuel du système d’exploitation serveur <version> | VDAServerSetup.exe |
| Agent de livraison virtuel de SE de bureau <version> | VDAWorkstationSetup.exe |
| Agent de livraison virtuel des services principaux de SE de bureau <version> | VDAWorkstationCoreSetup.exe |
- Extrayez d’abord les fichiers du package vers un répertoire existant, puis exécutez la commande d’installation, ou exécutez simplement le package.
Pour extraire les fichiers avant de les installer, utilisez /extract avec le chemin absolu, par exemple .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. (Le répertoire doit exister. Sinon, l’extraction échoue.) Ensuite, dans une commande distincte, exécutez XenDesktopVdaSetup.exe à partir du répertoire contenant le contenu extrait (dans l’exemple précédent, CitrixVDAInstallMedia). Utilisez les options valides dans Options de ligne de commande pour l’installation d’un VDA.
Pour exécuter le package téléchargé, exécutez simplement son nom : VDAServerSetup.exe, VDAWorkstationSetup.exe, ou VDAWorkstationCoreSetup.exe. Utilisez les options valides dans Options de ligne de commande pour l’installation d’un VDA.
Si vous êtes familiarisé avec le programme d’installation complet du produit :
-
Exécutez le programme d’installation autonome
VDAServerSetup.exeouVDAWorkstationSetup.execomme s’il s’agissait de la commandeXenDesktopVdaSetup.exepour tout, sauf son nom. -
Le programme d’installation
VDAWorkstationCoreSetup.exeest 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 des composants principaux
Les options 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.
/components <composant> [,<component>] …
Liste de composants à installer ou à supprimer, séparés par des virgules. Les valeurs valides sont :
CONTROLLER: Contrôleur
DESKTOPSTUDIO : Studio
DESKTOPDIRECTOR : Director
LICENSESERVER : Serveur de licences Citrix
Si cette option est omise, tous les composants sont installés (ou supprimés, si l’option /remove est également spécifiée).
(Dans les versions antérieures à 7.15 LTSR CU6, les valeurs valides incluaient StoreFront. Pour la version 7.15 LTSR CU6 et ultérieure, utilisez la commande d’installation StoreFront dédiée mentionnée dans Installer StoreFront).
/configure_firewall
Ouvre tous les ports du pare-feu Windows utilisés par les composants en cours d’installation, si le service Pare-feu Windows est en cours d’exécution, même si le pare-feu n’est pas activé. Si vous utilisez un pare-feu tiers ou aucun pare-feu, vous devez ouvrir les ports manuellement.
/désactiverlesmétriquesd’expérience
Empêche le téléchargement automatique des analyses collectées lors de l’installation, de la mise à niveau ou de la suppression vers Citrix.
/exclure
Empêche l’installation d’une ou plusieurs fonctionnalités, services ou technologies séparés par des virgules, entre guillemets droits. Les valeurs valides sont :
Local Host Cache Storage (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 de site.
Smart Tools Agent : Empêche l’installation de l’agent Citrix Smart Tools.
Remarque :
À partir de CU4, Smart Tools n’est plus inclus dans le programme d’installation. Les instances de Smart Tools présentes des installations antérieures restent intactes.
/help ou /h
Affiche l’aide de la commande.
/installdir <répertoire>
Répertoire vide existant où les composants seront installés. Par défaut = c:\Program Files\Citrix.
/logpath <chemin>
Emplacement du fichier journal. Le dossier spécifié doit exister. Le programme d’installation ne le crée pas. Par défaut = "%TEMP%\Citrix\XenDesktop Installer"
/no_remote_assistance
Valide uniquement lors de l’installation de Director. Désactive la fonctionnalité d’observation de l’utilisateur qui utilise l’Assistance à distance Windows.
Pas de redémarrage
Empêche un redémarrage après l’installation. (Pour la plupart des composants principaux, un redémarrage n’est pas activé par défaut.)
Pas de SQL
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’a aucun effet sur l’installation de SQL Server Express LocalDB utilisé pour le cache d’hôte local.)
/quiet ou /passive
Aucune interface utilisateur n’apparaît pendant l’installation. La seule preuve du processus d’installation se trouve dans le Gestionnaire des tâches de Windows. Si cette option est omise, l’interface graphique se lance.
Supprimer
Supprime les composants principaux spécifiés avec l’option /components.
/supprimertout
Supprime tous les composants principaux installés.
/envoyermetriquesexperience
Envoie automatiquement à Citrix les analyses collectées lors de l’installation, de la mise à niveau ou de la suppression. Si cette option est omise (ou si /disableexperiencemetrics est spécifié), les analyses sont collectées localement, mais ne sont pas envoyées automatiquement.
/tempdir <répertoire>
Répertoire qui contient les fichiers temporaires pendant l’installation. Par défaut = c:\Windows\Temp.
Option /xenapp
Installe XenApp. Si cette option est omise, XenDesktop® est installé.
Exemples : Installation des composants principaux
La commande suivante installe un contrôleur XenDesktop, 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 XenApp®, 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
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.
Image de base
Valide uniquement lors de l’installation d’un VDA pour OS de bureau sur une VM. Permet l’utilisation de Personal vDisk avec une image principale. Pour plus de détails, consultez Personal vDisk.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe.
Composants <composant>[,<component>]
Liste des composants à installer ou à supprimer, séparés par des virgules. Les valeurs valides sont :
VDA : Virtual Delivery Agent
PLUGINS : Citrix Receiver pour Windows (CitrixReceiver.exe)
Par exemple, pour installer le VDA mais pas Citrix Receiver, spécifiez /components vda.
Si cette option est omise, tous les composants sont installés.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup.exe. Ce programme d’installation ne peut pas installer de Citrix Receiver.
/contrôleurs “<contrôleur> [<controller>] […]”
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 des analyses collectées lors de l’installation, de la mise à niveau ou de la suppression vers Citrix.
/enable_framehawk_port
Ouvre les ports UDP utilisés par Framehawk. Par défaut = false
/enable_hdx_3d_pro
Installe le VDA en mode HDX™ 3D Pro.
/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 et 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 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 d’autres ports utilisés par le VDA, spécifiez l’option /enable_hdx_ports et l’option /enable_hdx_udp_ports.
/enable_real_time_transport
Active ou désactive l’utilisation d’UDP pour les paquets audio (transport audio en temps réel pour l’audio). L’activation de cette fonctionnalité peut améliorer les performances audio. Incluez l’option /enable_hdx_ports si vous souhaitez que les ports UDP soient ouverts automatiquement lorsque le service Pare-feu Windows est détecté.
/enable_remote_assistance
Active la fonctionnalité d’observation 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.
/exclure “<composant>”[,”<component>”]
Empêche l’installation d’un ou plusieurs composants facultatifs séparés par des virgules, 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 les composants Personal vDisk ou Machine Identity Service. Les valeurs valides sont :
Personal vDiskMachine Identity ServiceCitrix User Profile ManagerCitrix User Profile Manager WMI PluginCitrix Universal Print ClientCitrix Telemetry ServiceCitrix Personalization for App-V - VDA
L’exclusion de Citrix Profile Management de l’installation (à l’aide de l’option /exclude "Citrix User Profile Manager") affecte la surveillance et le dépannage des VDA avec Citrix Director. Sur les pages Détails de l’utilisateur et Point de terminaison, le panneau Personnalisation et le panneau Durée de l’ouverture de session échouent. Sur les pages Tableau de bord et Tendances, le panneau Durée moyenne de l’ouverture de session affiche les données uniquement pour les machines sur lesquelles Profile Management est installé.
Même si vous utilisez une solution de gestion des profils utilisateur tierce, Citrix vous recommande d’installer et d’exécuter le service Citrix Profile Management. L’activation du service Citrix Profile Management n’est pas obligatoire.
Cette option n’est pas valide lors de l’utilisation de l’installateur VDAWorkstationCoreSetup.exe. Cet installateur exclut automatiquement de nombreux éléments.
/h ou /help
Affiche l’aide de la commande.
/hdxflashv2only
Empêche l’installation des binaires hérités de la redirection Flash, pour une sécurité renforcée.
Cette option n’est pas disponible dans l’interface graphique.
/répinstall <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"
Cette option n’est pas disponible dans l’interface graphique.
/imagemaitre
Valide uniquement lors de l’installation d’un VDA sur une VM. Configure le VDA comme une image maître.
Cette option n’est pas valide lors de l’utilisation de l’installateur VDAWorkstationCoreSetup.exe.
/no_mediafoundation_ack
Reconnaît que Microsoft Media Foundation n’est pas installé, et que plusieurs fonctionnalités multimédia HDX ne seront pas installées et ne fonctionneront pas. Si cette option est omise et que Media Foundation n’est pas installé, l’installation du VDA échoue. La plupart des éditions de Windows prises en charge sont livrées avec Media Foundation déjà installé, à l’exception des éditions N.
/sanscitrixwddm
Valide uniquement sur les machines Windows 7 qui n’incluent pas de pilote WDDM. Désactive l’installation du pilote Citrix WDDM.
Cette option n’est pas disponible dans l’interface graphique.
/sansexpériencedebureau
Valide uniquement lors de l’installation d’un VDA pour OS serveur. 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.
Ne pas redémarrer
Empêche un redémarrage après l’installation. Le VDA ne peut pas être utilisé avant un redémarrage.
Ne pas reprendre
Par défaut, lorsqu’un redémarrage de la machine est nécessaire pendant une installation, le programme d’installation reprend automatiquement une fois le redémarrage terminé. Pour annuler la valeur par défaut, spécifiez /noresume. Cela peut être utile si vous devez remonter le support ou si vous souhaitez capturer des informations lors d’une installation automatisée.
Optimiser
Valide uniquement lors de l’installation d’un VDA sur une VM. Active l’optimisation pour les VDA exécutés dans une VM sur un hyperviseur. L’optimisation de la VM inclut la désactivation des fichiers hors ligne, la désactivation de la défragmentation en arrière-plan et la réduction de la taille du journal des événements. Ne spécifiez pas cette option pour les déploiements d’accès PC distant. Pour plus d’informations, consultez CTX224676.
Numéro de port <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.
Silencieux ou passif
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. Exclut l’installation des composants suivants sur un OS de bureau :
- Personnalisation Citrix pour App-V
- Gestionnaire de profils utilisateur Citrix
- Plug-in WMI du gestionnaire de profils utilisateur Citrix
- Service d’identité de machine
- vDisk personnel
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.
Suppression
Supprime les composants spécifiés avec l’option /components.
Suppression complète
Supprime tous les composants VDA installés.
Envoi des métriques d’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 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 de bureau sur un serveur Windows pris en charge. Omettez cette option lors de l’installation d’un VDA pour OS de serveur sur un serveur Windows. Avant d’utiliser cette option, consultez Server VDI.
Utilisez cette option uniquement avec le programme d’installation VDA complet. Cette option n’est pas disponible dans l’interface graphique.
/identifiant_site <guid>
Identifiant 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.
/répertoire_temporaire <directory>
Répertoire pour stocker les fichiers temporaires pendant l’installation. Par défaut = c:\Windows\Temp.
Cette option n’est pas disponible dans l’interface graphique.
/machine_virtuelle
Valide uniquement lors de l’installation d’un VDA sur une VM. Outrepasse la détection par l’installateur 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.
Exemples : Installer un VDA
Installer un VDA avec l’installateur complet du produit
La commande suivante installe un VDA pour OS de bureau et Citrix Receiver™ à l’emplacement par défaut sur une VM. Ce VDA sera utilisé comme image principale. Le VDA s’enregistrera initialement auprès du Controller sur le serveur nommé ‘Contr-Main’ dans le domaine ‘mydomain’. Le VDA utilisera les Personal vDisks, la fonctionnalité d’optimisation et l’Assistance à distance Windows.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance
Installer un VDA pour OS de bureau avec l’installateur autonome VDAWorkstationCoreSetup
La commande suivante installe un VDA de services de base sur un OS de bureau pour une utilisation dans un déploiement d’accès PC à distance ou VDI. Citrix Receiver 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 à l’aide de la ligne de commande
Après avoir installé un VDA, vous pouvez personnaliser plusieurs paramètres. Depuis le répertoire \x64\XenDesktop Setup sur le support du produit, exécutez la commande 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) -
/hou/help /quiet/noreboot/controllers- Port
/portnumber /enable_hdx_ports
Installer le serveur d’impression universel à l’aide de la ligne de commande
Exécutez l’une des commandes suivantes sur chaque serveur d’impression :
- Sur un système d’exploitation 32 bits pris en charge : Depuis le répertoire
\x86\Universal Print Server\sur le support d’installation Citrix, exécutezUpsServer_x86.msi. - Sur un système d’exploitation 64 bits pris en charge : Depuis le répertoire
\x64\Universal Print Server\sur le support d’installation Citrix, exécutezUpsServer_x64.msi.
Après avoir installé le composant Universal Print Server sur vos serveurs d’impression, configurez-le en suivant les instructions de Provisionner les imprimantes.
Dans cet article
- Utiliser le programme d’installation complet du produit
- Utiliser un programme d’installation VDA autonome
- Options de ligne de commande pour l’installation des composants principaux
- Exemples : Installation des composants principaux
- Options de ligne de commande pour l’installation d’un VDA
- Exemples : Installer un VDA
- Personnaliser un VDA à l’aide de la ligne de commande
- Installer le serveur d’impression universel à l’aide de la ligne de commande