Installation à 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 si nécessaire pour 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 pour installer, mettre à niveau ou supprimer 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 non prise en charge pour cette version de Citrix Virtual Apps and Desktops, un message vous guide vers des informations sur vos options. Consultez Systèmes d’exploitation antérieurs.
Pour plus d’informations sur la manière 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 :
- 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
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 de [Options de ligne de commande pour l'installation d'un serveur d'impression universel](#command-line-options-for-installing-a-universal-print-server).
**Pour installer le service d'authentification fédérée :** Citrix recommande d'utiliser l'interface graphique. url-or-ip
**Pour installer l'enregistrement de session :** Suivez les instructions de [Enregistrement de session](/fr-fr/session-recording.html).
-
Pour installer Workspace Environment Management : Suivez les instructions de Workspace Environment Management.
-
Pour installer Secure Private Access : Exécutez
XenDesktopSPASetup.exedans le dossierx64 > XenDesktop Setupsur le support d’installation. Suivez les instructions de Options de ligne de commande pour l’installation d’un Secure Private Access.
-
Pour installer Secure Private Access : Exécutez
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` lorsque vous utilisez 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. Ceci afin 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*] ...
- Active 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](/fr-fr/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-call-home).
Pour plus de détails sur la collecte des données CEIP, consultez [Programme d'amélioration de l'expérience client de Citrix Licensing](/fr-fr/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-customer-experience-improvement-program).
Pour plus de détails sur les données CEIP, consultez [Éléments de données CEIP de Citrix Licensing](/fr-fr/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-ceip-data-elements).
Pour plus de détails sur les données de licence du serveur de licences, consultez [Données de licence Citrix](/fr-fr/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-compliance).
-
/components composant [,composant] …
Liste de composants séparés par des virgules à installer ou à supprimer. Les valeurs valides sont :
-
CONTROLLER: Contrôleur -
DESKTOPSTUDIO: Studio -
WEBSTUDIO: Web Studio -
DESKTOPDIRECTOR: Director -
LICENSESERVER: Serveur de licences Citrix -
SECUREPRIVATEACCESS: Secure Private Access
-
Pour installer uniquement le VDA et exclure l’installation d’autres composants Citrix, spécifiez /components vda.
Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup_xxxx.exe. Ce programme d’installation ne peut pas installer l’application Citrix Workspace ou d’autres composants 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 à 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).
-
/onlyprereqs
Seuls les prérequis pour les composants sélectionnés seront installés. Aucun composant produit Citrix ne sera installé.
-
/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 manuellement les ports.
-
/disableexperiencemetrics
Empêche le téléchargement automatique des données analytiques 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 à l’installation ou à la mise à niveau du Delivery Controller de se poursuivre, même si les vérifications matérielles échouent (par exemple, en raison d’une mémoire vive (RAM) insuffisante). Pour plus d’informations, consultez Vérification matérielle.
-
/ignore_site_test_failure
Valide uniquement pendant la mise à niveau du Controller. Généralement, tous les échecs des tests de site sont ignorés et la mise à niveau se poursuit. Si cette option est omise (ou définie 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.
-
/installdir directory
Répertoire vide existant où les composants seront installés. Par défaut = c:\Program Files\Citrix.
-
/logpath path
- Emplacement du fichier journal. Le dossier spécifié doit exister. L’installateur ne le crée pas. Par défaut =
TEMP%\Citrix\XenDesktop Installer
- Emplacement du fichier journal. Le dossier spécifié doit exister. L’installateur ne le crée pas. Par défaut =
-
/no_remote_assistance
-
Valide uniquement lors de l’installation de Director. Désactive la fonctionnalité d’observation des utilisateurs qui utilise l’Assistance à distance Windows.
-
/noreboot
-
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.)
-
/noresume
-
Par défaut, lorsqu’un redémarrage de la machine est nécessaire pendant une installation, l’installateur 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 pendant une installation automatisée. -
/nosql
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 du site.
Cette option n’affecte pas 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.
-
-
/remove
- Supprime les composants principaux spécifiés avec l’option
/components.
- Supprime les composants principaux spécifiés avec l’option
-
/removeall
- Supprime tous les composants principaux installés.
-
/sendexperiencemetrics
Envoie automatiquement à Citrix les données analytiques collectées lors de l’installation, de la mise à niveau ou de la suppression. Si cette option est omise (ou si
/disableexperiencemetricsest spécifié), les données analytiques sont collectées localement, mais non envoyées automatiquement. -
/tempdir directory
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 du 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 du 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 du pare-feu requis pour la communication des composants sont ouverts automatiquement.
- `\x64\XenDesktop Setup
- XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall`
- Si vous effectuez une mise à niveau de Citrix Virtual Apps and Desktops version 2407 vers la version 2411 ou ultérieure, ou si vous effectuez une nouvelle installation de la version 2411 ou ultérieure, mettez à jour le serveur de licences vers la dernière version (version 11.2.17 build 51000) en première étape. Ensuite, mettez à niveau le Delivery Controller. Ne pas le faire entraîne l'échec des installations et des mises à niveau en ligne de commande. Exécutez les commandes suivantes pour mettre à niveau le serveur de licences et les composants tels que le Delivery Controller, Web Studio et Citrix Director (en supposant que vous êtes dans le dossier \x64 de l'ISO monté).
- 1. Exécutez ce qui suit :
```
\x64\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy--> ```
Si vous avez copié les binaires de licence sur l'un des lecteurs locaux, exécutez la commande suivante :
```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```
-
Exécutez ce qui suit :
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL <!--NeedCopy-->
Utiliser un programme d’installation VDA autonome
Les informations d’identification du 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.
- Téléchargez le package approprié depuis Citrix :
- Agent de livraison virtuel pour OS multi-session :
VDAServerSetup_xxxx.exe - Agent de livraison virtuel pour OS mono-session :
VDAWorkstationSetup_xxxx.exe - Agent de livraison virtuel des services de base pour OS mono-session :
VDAWorkstationCoreSetup_xxxx.exe
- Agent de livraison virtuel pour OS multi-session :
-
Extrayez 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
/extractavec le chemin absolu, par exempleC:\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 listées dans cet article.-
Pour
VDAServerSetup_XXXX.exe, exécutez<dossier d'extraction>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe -
Pour
VDAWorkstationCoreSetup_XXXX.exe, exécutez<dossier d'extraction>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe -
Pour
VDAWorkstationSetup_XXXX.exe, exécutez<dossier d'extraction>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
Pour exécuter le package téléchargé, exécutez son nom :
VDAServerSetup.exe,VDAWorkstationSetup.exeouVDAWorkstationCoreSetup.exe. Utilisez les options valides listées dans cet article. -
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.exe, à l’exception de 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.
Liste de composants séparés par des virgules à installer ou à supprimer. Les valeurs valides sont :
-
VDA: Agent de livraison virtuel -
CSA: Client Citrix Secure Access™ -
PLUGINS: application Citrix Workspace™ pour Windows -
UPL: Couche de personnalisation utilisateur Citrix (uniquement pour VDA WS) -
SRAGENT: Agent d’enregistrement de session -
ASSISTANTAPP: application d’assistance Citrix (uniquement pour VDA WS)-
CEAL: Superposition d’applications élastiques Citrix (uniquement pour VDA TS)
-
Pour installer le VDA et l’application Citrix Workspace pour Windows, spécifiez /components vda,plugins ou ne spécifiez aucun composant.
À partir de cette version, Citrix Device Trust, Citrix uberAgent et l’agent Citrix Workspace Environment Management™ (WEM) sont intégrés dans l’installation VDA par défaut. Ces composants sont installés silencieusement dans le cadre de la configuration du VDA et ne sont plus gérés comme des composants distincts.
Remarque : - > Si une version autonome existante de Citrix uberAgent® est détectée dans l’environnement, elle ne sera pas installée, mise à niveau ou désinstallée par le programme d’installation.
Pour installer uniquement le VDA et exclure l’installation d’autres composants Citrix, spécifiez /components vda.
- Cette option n’est pas valide lors de l’utilisation du programme d’installation VDAWorkstationCoreSetup_xxxx.exe. Ce programme d’installation ne peut pas installer l’application Citrix Workspace ou d’autres composants Citrix.
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 des 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 -
CSA: Client Citrix Secure Access -
UPL: Couche de personnalisation utilisateur Citrix (uniquement pour VDA WS) -
SRAGENT: Agent d’enregistrement de session -
ASSISTANTAPP: application d’assistance Citrix (uniquement pour VDA WS) -
CEAL: Superposition d’applications élastiques Citrix (uniquement pour VDA TS)
-
-
Pour installer le VDA et l’application Citrix Workspace pour Windows, spécifiez
/components vda, plugins, CSA, UPLou ne spécifiez aucun composant. Si aucun composant n’est spécifié, seuls le VDA, SRAGENT et ASSISTANTAPP seront installés par défaut. -
Pour installer uniquement le VDA et exclure l’installation de l’application Citrix Workspace et d’autres composants, spécifiez
/components vda. -
Cette option n’est pas valide lors de l’utilisation du programme d’installation
VDAWorkstationCoreSetup_xxxx.exe. Ce programme d’installation ne peut pas installer l’application Citrix Workspace. -
/onlyprereqs
- Seuls les prérequis pour les composants sélectionnés seront installés. Aucun composant produit Citrix ne sera installé.
-
/controllers “contrôleur [contrôleur]”
-
Noms de domaine complets (FQDN) des contrôleurs avec lesquels le VDA peut communiquer, séparés par des espaces et entre guillemets droits. Ne spécifiez pas les options
/site_guidet/controllerssimultanément. -
/disableexperiencemetrics
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_portsen plus de cette option/enable_hdx_ports. -
/enable_hdx_udp_ports
-
Ouvre les ports UDP du 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 des ports supplémentaires utilisés par le VDA, spécifiez l’option
/enable_hdx_portsen 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 (RealTime Audio Transport pour l’audio). L’activation de cette fonctionnalité peut améliorer les performances audio. Incluez l’option
/enable_hdx_portssi 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 le retour automatique au point de restauration en cas d’échec de l’installation ou de la mise à niveau du VDA.
Si l’installation/la mise à niveau se termine avec succès :
-
/enablerestorecleanupindique au programme d’installation de supprimer le point de restauration. -
/enablerestoreindique au programme d’installation 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_SECURE_DEFAULTS
-
Modifie le paramètre par défaut de diverses fonctionnalités, de activé à désactivé, pour une configuration prête à l’emploi plus sécurisée. Les fonctionnalités concernées sont : la redirection de lecteur client, la redirection de dossier spécial, le glisser-déposer, la redirection de périphérique TWAIN client, la redirection de périphérique USB Plug and Play client, la redirection d’imprimante client, la redirection de presse-papiers client et la redirection de microphone client.
-
/enable_ss_ports
-
Ouvre les ports du pare-feu Windows 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 pare-feu différent ou aucun pare-feu, vous devez configurer le pare-feu manuellement.
-
/SKIPHDXDRIVERCHECK
Ignore la vérification des pilotes HDX™ par le méta-programme d’installation du VDA.
-
/exclude “composant”[,”composant”]
Empêche l’installation d’un ou plusieurs composants facultatifs séparés par des virgules, chacun étant 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 Machine Identity Service. Les valeurs valides sont les suivantes :
OS multi-session OS mono-session Services de base de l’OS mono-session Plug-in VDA d'assertion d'identité d'authentification CitrixPlug-in VDA d'assertion d'identité d'authentification CitrixPlug-in VDA d'assertion d'identité d'authentification CitrixSauvegarde et restauration CitrixSauvegarde et restauration CitrixRedirection de contenu de navigateur Citrix -
Citrix deviceTRUST®Citrix deviceTRUSTCitrix deviceTRUSTuberAgent®uberAgentuberAgent -
Client d'accès sécurisé CitrixClient d'accès sécurisé CitrixClient d'accès sécurisé CitrixAgent Citrix Workspace Environment Management™Agent Citrix Workspace Environment ManagementAgent Citrix Workspace Environment Management -
Redirection de contenu de navigateur CitrixRedirection de contenu de navigateur CitrixPersonnalisation Citrix pour App-V - VDAPilote E/S MCS CitrixPilote E/S MCS CitrixService de télémétrie Citrix -
Personnalisation Citrix pour App-V - VDAPersonnalisation Citrix pour App-V - VDAClient d'impression universel™ CitrixGestion des profils CitrixGestion des profils CitrixService de capture des journaux VDA Citrix -
Plug-in WMI de gestion des profils CitrixPlug-in WMI de gestion des profils CitrixComposant CSECitrix Rendezvous V2Citrix Rendezvous V2Plug-in VDA Director -
Service de télémétrie CitrixService de télémétrie CitrixFournisseur de gestion de machineClient d'impression universel™ CitrixClient d'impression universel™ CitrixPlug-in de surveillance VDAService de capture des journaux VDA CitrixService de capture des journaux VDA CitrixPlug-in proxy WMI VDAAgent de mise à niveau VDA CitrixAgent de mise à niveau VDA CitrixComposant CSEComposant CSEPlug-in VDA DirectorPlug-in VDA DirectorService d'identité de machineService d'identité de machineFournisseur de gestion de machineFournisseur de gestion de machinePlug-in de surveillance VDACouche de personnalisation utilisateurPlug-in proxy WMI VDAPlug-in de surveillance VDAPlug-in proxy WMI VDAComposant de protection d'application CitrixComposant de protection d'application CitrixComposant de protection d'application CitrixPilote de filtre HyperV CitrixPilote de filtre HyperV CitrixPersonnalisation Citrix pour App-V - VDAPersonnalisation Citrix pour App-V - VDAPersonnalisation Citrix pour App-V - VDAAgent d'enregistrement de sessionAgent d'enregistrement de sessionElastic App LayeringApplication d'assistance CitrixL’exclusion de la gestion des profils Citrix 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 la session échouent. Sur les pages Tableau de bord et Tendances, le panneau Durée moyenne de la 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 de gestion des profils Citrix. L’activation du service de gestion des profils Citrix n’est pas obligatoire.
Si vous spécifiez à la fois
/excludeet/includeadditionalavec 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 :
Système d’exploitation multi-session Système d’exploitation mono-session Citrix Backup and RestoreCitrix Backup and RestoreCitrix MCS IODriverCitrix MCS IODriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Profile ManagementCitrix Profile ManagementCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCitrix Rendezvous V2Citrix Rendezvous V2Citrix VDA Upgrade AgentCitrix VDA Upgrade AgentCitrix Web Socket Vda Registration ToolCitrix Web Socket Vda Registration ToolMachine Identity ServiceMachine Identity ServiceUser Personalization LayerSi vous spécifiez à la fois
/excludeet/includeadditionalavec 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. Le programme d’installation ne le crée pas. Par défaut = “%TEMP%\Citrix\XenDesktop Installer”
Cette option n’est pas disponible dans l’interface graphique.
-
/masterimage
Valide uniquement lors de l’installation d’un VDA sur une machine virtuelle. 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 du programme d’installation
VDAWorkstationCoreSetup_xxxx.exe. -
/mastermcsimage
Spécifie que cette machine sera utilisée comme image avec Machine Creation Services. Cette option est équivalente à
/masterimage. -
/masterpvsimage
Spécifie que cette machine sera utilisée comme image avec Citrix Provisioning™ ou un outil de provisioning tiers (tel que Microsoft System Center Configuration Manager) pour provisionner des machines virtuelles.
-
/websockettoken WebSocketToken
Crée un VDA Web Socket. Le WebSocketToken correspond au jeton requis.
-
/websockettokenfile FichierContenantLeJetonWebSocket
Crée un VDA Web Socket. Le FichierContenantLeJetonWebSocket correspond au fichier qui contient le jeton requis.
-
/websockettokenstdin <WebSocketToken
Crée un VDA Web Socket. Le <WebSocketToken correspond au jeton requis qui est transmis via STDIN.
-
/no_mediafoundation_ack
Reconnaît que Microsoft Media Foundation n’est pas installé et que plusieurs fonctionnalités multimédias 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édias, la clé de registre recherchée par le programme d’installation Citrix Meta peut ne pas avoir de valeur définie. Vérifiez la clé de registre
SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersionavant de démarrer le processus d’installation pour confirmer que la valeur existe et n’est pas vide. -
/nodesktopexperience
La fonctionnalité Enhanced Desktop Experience 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é Enhanced Desktop Experience. Cette fonctionnalité est également contrôlée par le paramètre de stratégie Citrix Enhanced Desktop Experience.
-
/noreboot
Empêche un redémarrage après l’installation. Le VDA ne peut pas être utilisé avant 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 remonter le support ou si vous souhaitez capturer des informations lors d’une installation automatisée. -
/physicalmachine
Utilisez cet argument avec
/remotepcpour l’installation RemotePC. Sinon, le VDA pourrait ne pas se comporter comme prévu dans certains scénarios utilisateur. -
/portnumber port
Valide uniquement lorsque l’option
/reconfigest 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 des services tels 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. Cette ligne de commande installe automatiquement Citrix Rendezvous V2 comme si
/includeadditional "Citrix Rendezvous V2"avait été utilisé. 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
- Format de l’adresse du proxy :
-
/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.
-
/reconfigure
Personnalise les paramètres VDA précédemment configurés lorsqu’elle est utilisée avec les options
/portnumber,/controllersou/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. -
/remotepc
Valide uniquement pour les déploiements d’accès PC distant (OS à session unique) ou les connexions intermédiées (OS à sessions multiples). Exclut l’installation de tout composant supplémentaire (voir les listes de composants avec les options
/excludeet/includeadditional).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./remotepcn’est pas compatible avec l’option/servervdi. -
/remove
Supprime les composants spécifiés avec l’option
/components. -
/remove_appdisk_ack
Autorise le programme d’installation du VDA à désinstaller le plug-in VDA AppDisks™ s’il est installé.
-
/remove_pvd_ack
Autorise le programme d’installation du VDA à désinstaller Personal vDisk s’il est installé.
-
/removeall
Supprime le VDA. Il ne supprime pas l’application Citrix Workspace (si elle est installée).
-
/REMOVEALLWITHCWA
Supprime CWA avec le VDA.
-
/sendexperiencemetrics
Envoie automatiquement à Citrix les analyses collectées pendant l’installation, la mise à niveau ou la suppression. Si cette option est omise (ou si l’option
/disableexperiencemetricsest spécifiée), les analyses sont collectées localement, mais ne sont pas envoyées automatiquement. -
/servervdi
Installe un VDA pour OS à session unique sur une machine Windows multi-session prise en charge. Omettez cette option lors de l’installation d’un VDA pour OS à sessions multiples sur une machine Windows multi-session.
Avant d’utiliser cette option, consultez Server VDI.
Utilisez cette option uniquement avec le programme d’installation VDA complet.
-
/site_guid guid
Identificateur global unique (GUID) de l’unité d’organisation (OU) 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 à la fois les options
/site_guidet/controllers. -
/tempdir 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.
-
/virtualmachine
Valide uniquement lors de l’installation d’un VDA sur une machine virtuelle. Outrepasse la détection par le programme d’installation d’une machine physique, lorsque les informations BIOS transmises aux machines virtuelles les font apparaître comme des machines physiques.
Cette option n’est pas disponible dans l’interface graphique.
-
/xendesktopcloud
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 machine virtuelle. Ce VDA sera utilisé comme image et utilisera MCS pour provisionner des machines virtuelles. 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\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy--> ```
Installer un VDA pour OS à session unique avec le programme d’installation autonome VDAWorkstationCoreSetup :
La commande suivante installe un VDA Core Services sur un OS à session unique pour une utilisation dans un déploiement Remote PC Access 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.
```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```
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(obligatoire lors de la personnalisation d’un VDA) -
/hou/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.
-
Après l’installation d’un VDA, 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 des VDA et sur la façon de résoudre les problèmes d’enregistrement, consultez Enregistrement des 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 l’Universal Print Server en suivant les instructions de Citrix Universal Print Server (UPS).
Options de ligne de commande pour l’installation de Secure Private Access
Les options suivantes sont valides avec les deux :
- Programme d’installation CVAD :
XenDesktopSPASetup.exe - Programme d’installation SPA sur site :
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_ports
Ouvre les ports du 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.
-
/nosql
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
-
/noreboot
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.
-
/remove
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 de Citrix.
Dans cet article
- Introduction
- Utiliser le programme d’installation complet du produit
- Options de ligne de commande pour l’installation des composants principaux
- Exemples d’installation des composants principaux
- Utiliser un programme d’installation VDA autonome
- Options de ligne de commande pour l’installation d’un VDA
- Exemples d’installation d’un VDA
- Personnaliser un VDA
- Dépanner les VDA
- Options de ligne de commande pour l’installation d’un Universal Print Server
- Options de ligne de commande pour l’installation de Secure Private Access
- Plus d’informations