Product Documentation

Installer à l'aide de la ligne de commande

Oct 21, 2016
À l'aide de l'interface de ligne de commande, vous pouvez :
  • Installer un ou plusieurs composants principaux : Delivery Controller, Citrix Studio, Citrix Director, le serveur de licences et StoreFront.
  • Installer Virtual Delivery Agent (VDA) sur une image principale ou sur une machine physique ou virtuelle.

    Vous pouvez également personnaliser les scripts fournis sur le support, puis les utiliser pour installer et supprimer des VDA dans Active Directory ; consultez la section Installer ou supprimer des Virtual Delivery Agents à l'aide de scripts dans Active Directory.

  • Personnaliser un VDA précédemment installé.
  • Installer un serveur d'impression universelle, qui provisionne les imprimantes réseau de session. (Le Controller dispose déjà de la fonctionnalité Serveur d'impression universelle ; vous devez installer uniquement le Serveur d'impression universelle sur les serveurs d'impression dans votre environnement.)

Vous pouvez également supprimer les composants XenDesktop 7 précédemment installés, à l'aide de l'option /remove ou/removeall. Pour de plus amples informations, consultez la section Supprimer des composants.

Pour pouvoir suivre la progression de l'exécution de la commande en cours et des valeurs de retour, vous devez être l’administrateur d'origine ou utiliser l'option « Exécuter en tant qu'administrateur ». Pour plus d'informations, veuillez consulter la documentation des commandes Microsoft.

Pour installer les composants de base à l'aide de la ligne de commande

À partir du répertoire \x64\XenDesktop Setup du support d'installation, exécutez la commande XenDesktopServerSetup.exe. Le tableau suivant décrit les options de commande.
Option Description

/help ou/h

Affiche la commande d'aide.

/quiet

Aucune interface utilisateur ne s'affiche lors de l'installation. La seule preuve de l'installation est dans le Gestionnaire des tâches Windows. Si cette option n'est pas utilisée, l'interface graphique démarre.

/logpath chemin

Emplacement du fichier journal. Le dossier spécifié doit déjà exister ; il n'est pas créé par le programme d'installation. Valeur par défaut = "%TEMP%\Citrix\XenDesktop Installer"

/noreboot

Empêche un redémarrage après l'installation. (Pour la plupart des composants principaux, aucun redémarrage n'est activé par défaut).

/remove

Supprime les principaux composants spécifiés avec l'option /components. Pour de plus amples informations sur la suppression de composants, consultez la section Supprimer des composants.

/removeall

Supprime tous les principaux composants installés. Pour de plus amples informations sur la suppression de composants, consultez la section Supprimer des composants.

/configure_firewall

Ouvre tous les ports du pare-feu Windows requis par les composants installés, 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.
  • Controller : TCP 80, 443
  • Director : TCP 80, 443
  • Serveur de licences : TCP 7279, 8082, 8083, 27000
  • StoreFront : TCP 80, 443

pour accéder à des informations complètes sur les ports, consultez l'article CTX101810.

/components composant [,composant] ...

(Obligatoire). Liste séparée par des virgules des composants à installer ou supprimer. Les valeurs autorisées sont :
  • CONTROLLER - Controller
  • DESKTOPSTUDIO - Studio
  • DESKTOPDIRECTOR - Director
  • LICENSESERVER - Citrix Licensing
  • STOREFRONT - StoreFront

Si cette option est omise, tous les composants sont installés (ou supprimés, si l'option /remove est également spécifiée).

/installdir répertoire

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

/tempdir répertoire

Répertoire qui contient les fichiers temporaires durant l'installation. Valeur par défaut : c:\Windows\Temp

/nosql

Empêche l'installation de Microsoft SQL Server Express sur le serveur sur lequel vous installez le Controller. Si cette option est omise, SQL Server Express sera installé.

/enableremoteassistance

(Valide uniquement lors de l'installation de Director.) Active la fonction Assistance à distance de Windows. L’Assistance à distance Windows est toujours installée lorsque vous installez Director ; activez ou désactivez la fonctionnalité en incluant ou ignorant cette option dans la ligne de commande.

Par exemple, la commande suivante installe un Controller, Studio, le système de licences Citrix et SQL Server Express sur le serveur. Les ports dans le pare-feu Windows qui sont requis pour les communications du Controller et du serveur de licences seront ouverts automatiquement.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

Pour installer un VDA à l'aide de la ligne de commande

Remarque : utilisez les instructions suivantes lors de l'installation de Virtual Delivery Agent sur Windows 7, Windows 8, Windows Server 2008 R2 ou Windows Server 2012. Pour plus d'informations sur l'installation d'une version antérieure de Virtual Desktop Agent sur Windows XP ou Windows Vista, consultez la section Installer une version antérieure de Virtual Desktop Agent sur Windows XP ou Windows Vista.

Lors de l'installation de Virtual Desktop Agent en vue d'une utilisation avec Remote PC Access, spécifiez uniquement les options qui sont valides sur des machines physiques (pas de VM ou des images principales) et pour les VDA pour système d'exploitation de bureau Windows.

À partir du répertoire \x64\XenDesktop Setup du support d'installation, exécutez la commande XenDesktopVdaSetup.exe. Le tableau suivant décrit les options de commande. Sauf spécification contraire, les options s'appliquent aux machines physiques et virtuelles, et aux VDA pour OS de bureau Windows et OS de serveur Windows.
Option Description

/h ou/help

Affiche la commande d'aide.

/quiet

Aucune interface utilisateur ne s'affiche lors de l'installation. La seule preuve de l'installation et de la configuration est dans le Gestionnaire des tâches Windows. Si cette option n'est pas utilisée, l'interface graphique démarre.

/logpath chemin

Emplacement du fichier journal. Le dossier spécifié doit déjà exister ; il n'est pas créé par le programme d'installation. Valeur par défaut = "%TEMP%\Citrix\XenDesktop Installer"

/noreboot

Empêche un redémarrage après l'installation. Le VDA ne sera entièrement disponible qu'après un redémarrage.

/remove

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

/removeall

Supprime tous les composants VDA installés.

/reconfig

Personnalise les paramètres VDA précédemment configurés lorsqu'il est utilisé avec les options /portnumber, /controllers ou /enable_hdx_ports. Si vous spécifiez cette option sans spécifier également l'option/quiet, l'interface graphique de personnalisation de VDA démarre.

/portnumber port

(Valide uniquement si l'option /reconfig est spécifiée.) Numéro de port à activer pour les communications entre le VDA et le Controller. Le port précédent configuré est désactivé, à moins qu'il s'agisse du port 80.

/components component[,component]

Liste séparée par des virgules des composants à installer ou supprimer. Les valeurs autorisées sont :
  • VDA : installe le VDA
  • PLUGINS : installe Citrix Receiver pour Windows (CitrixReceiver.exe)

Si cette option est omise, tous les composants sont installés.

/installdir répertoire

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

/tempdir répertoire

Répertoire sur lequel stocker les fichiers temporaires durant l'installation. (Cette option n'est pas disponible dans l'interface graphique.) Valeur par défaut = c:\Windows\Temp.

/site_guid guid

Identificateur global unique (GUID) de l'unité d'organisation Active Directory du site. Associe un bureau virtuel à un site lorsque vous utilisez Active Directory pour la découverte (la mise à jour automatique est la méthode recommandée et la méthode de découverte par défaut). Le GUID du site est une propriété de site affichée dans Studio. Ne spécifiez pas à la fois les options /site_guid et /controllers.

/controllers "contrôleur [contrôleur] [...]"

Noms de domaines complets (FQDN) séparés par des virgules des Controller avec lesquels le VDA peut communiquer, entourés de guillemets. Ne spécifiez pas à la fois les options /site_guid et /controllers.

/xa_server_location url

URL du serveur des applications du serveur Windows.

/enable_remote_assistance

Active l'Assistance à distance Windows à utiliser avec Director. Si vous spécifiez cette option, Windows ouvre le port TCP 3389 dans le pare-feu, même si vous omettez l'option /enable_hdx_ports.

/enable_hdx_ports

Ouvre les ports du pare-feu Windows requis par le Controller et les fonctionnalités que vous avez spécifiées (assistance à distance Windows, transport en temps réel et optimisation), si le service Pare-feu Windows est détecté, même si le pare-feu n'est pas activé. Si vous utilisez un autre pare-feu ou aucun pare-feu, vous devez configurer le pare-feu manuellement.
  • Controller : TCP 80, 1494, 2598, 8008

    Pour les communications entre les machines utilisateur et les bureaux virtuels, configurez le trafic TCP entrant sur les ports 1494 et 2598 en tant qu'exceptions de port. Pour des raisons de sécurité, Citrix vous recommande de ne pas utiliser ces ports pour autre chose que le protocole ICA et CGP.

    Pour les communications entre les Controller et les bureaux virtuels, configurez le port 80 entrant en tant qu'exception de port.

  • Assistance à distance Windows : TCP 3389.
  • Real-Time Transport audio : UDP 16500-16509

pour accéder à des informations complètes sur les ports, consultez l'article CTX101810.

/optimize

Permet l'optimisation des VDA exécutés dans une VM sur un hyperviseur. L'optimisation de VM comprend la désactivation des fichiers en mode déconnecté, la désactivation de la défragmentation en arrière-plan et la réduction de la taille du journal d'événements. Ne spécifiez pas cette option pour Remote PC Access. Pour plus d’informations sur l'outil d'optimisation, veuillez consulter l'article CTX125874.

/baseimage

(Valide uniquement lors de l'installation d'un VDA pour OS de bureau Windows sur une VM). Permet l'utilisation de Personal vDisks avec une image principale. Pour de plus amples informations, consultez la section Gestion des Personal vDisks.

/enable_hdx_3d_pro

Installe le VDA pour HDX 3D Pro. Pour plus d'informations, veuillez consulter la documentation de HDX 3D Pro.

/enable_real_time_transport

Active ou désactive l'utilisation d'UDP pour les paquets audio (Real-Time Audio Transport pour l'audio). L'activation de cette fonctionnalité peut améliorer les performances audio. Recommandé pour Remote PC Access. (Incluez l'option /enable_hdx_ports si vous souhaitez que les ports UDP soient ouverts automatiquement si le service Pare-feu Windows est détecté.)

/masterimage

(Valide uniquement lors de l'installation d'un VDA sur une VM) Définit le VDA en tant qu'image principale.

/isvirtual

(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, où les informations du BIOS transmises aux VM les font passer pour des machines physiques.

/nodesktopexperience

(Valide uniquement lors de l'installation d'un VDA pour OS de serveur Windows). Empêche l'activation de la fonctionnalité Enhanced Desktop Experience. Cette fonctionnalité est contrôlée par le paramètre de stratégie Citrix Expérience de bureau améliorée.

/nocitrixwddm

(Valide uniquement sur les machines Windows 7 qui ne contiennent pas un pilote WDDM). Cette option désactive l'installation du pilote Citrix WDDM.

/servervdi

Installe un VDA pour OS Windows Desktop sur un Windows Server pris en charge. Évitez cette option lors de l'installation d'un VDA pour OS Windows Server sur un Windows Server. Avant d'utiliser cette option, consultez la section Server VDI.

/installwithsecurebootenabled

Permet l'installation du VDA lorsque le démarrage sécurisé est activé. Si cette option est omise, un avertissement s'affiche indiquant que le démarrage sécurisé doit être désactivé pour que l'installation du VDA réussisse.

La commande suivante installe un VDA pour OS de bureau Windows et Citrix Receiver à l'emplacement par défaut sur une VM. Ce VDA sera utilisé comme une image principale. Le VDA s'enregistrera initialement auprès du Controller sur le serveur appelé « Contr-Main » dans le domaine « mondomaine », et utilisera des 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
La commande suivante installe un VDA pour OS de bureau Windows et Citrix Receiver à l'emplacement par défaut sur un PC de bureau qui sera utilisé avec Remote PC Access. La machine ne sera pas redémarrée une fois que le VDA est installé ; toutefois un redémarrage est nécessaire avant que le VDA puisse être utilisé. Le VDA s'enregistrera initialement auprès du Controller sur le serveur appelé « Contr-East » dans le domaine « mondomaine », et utilisera UDP pour les paquets audio. Les ports HDX seront ouverts si le service Pare-feu Windows est détecté.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-East.mydomain.local" /enable_hdx_ports /enable_real_time_transport /noreboot 

Pour personnaliser un VDA à l'aide de la ligne de commande

Une fois que vous avez installé un VDA, vous pouvez personnaliser plusieurs paramètres. À partir du répertoire \x64\XenDesktop Setup du support du produit, exécutez la commande XenDesktopVdaSetup.exe, à l'aide d'une ou plusieurs des options suivantes, qui sont décrites ci-dessus.
  • /reconfigure : cette option est requise lors de la personnalisation d'un VDA
  • /h ou/help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

Pour installer le Serveur d'impression universelle à 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 : à partir de \x86\Universal Print Server\ sur le support d'installation Citrix, exécutez UpsServer_x86.msi.
  • Sur un système d'exploitation 64 bits : à partir de \x64\Universal Print Server\ sur le support d'installation Citrix, exécutez UpsServer_x64.msi.