Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Installer des VDA à l’aide de scripts

March 18, 2026
Contributeur: 
C

Remarque :

Citrix n’est pas responsable des problèmes causés par des scripts adaptés aux environnements de production des clients. Pour tout problème d’installation lié à Citrix, ouvrez un dossier de support technique avec les journaux d’installation pertinents via le portail de support Citrix.

Cet article s’applique à l’installation de VDA sur des machines exécutant des systèmes d’exploitation Windows. Pour plus d’informations sur les VDA pour les systèmes d’exploitation Linux, consultez la documentation du Linux Virtual Delivery Agent.

Le support d’installation contient des exemples de scripts qui installent, mettent à niveau ou suppriment des Virtual Delivery Agents (VDA) pour les machines dans Active Directory. Vous pouvez également utiliser les scripts pour maintenir les images principales utilisées par Machine Creation Services™ et Citrix Provisioning (anciennement Provisioning Services).

Accès requis :

  • Les scripts nécessitent un accès en lecture pour tous au partage réseau où se trouve la commande d’installation du VDA. La commande d’installation est XenDesktopVdaSetup.exe dans l’ISO du produit complet, ou VDAWorkstationSetup.exe ou VDAServerSetup.exe dans un programme d’installation autonome.
  • Les détails de journalisation sont stockés sur chaque machine locale. Pour enregistrer les résultats de manière centralisée à des fins d’examen et d’analyse, les scripts nécessitent un accès en lecture et en écriture pour tous au partage réseau approprié.

Pour vérifier les résultats de l’exécution d’un script, examinez le partage de journaux central. Les journaux capturés incluent le journal du script, le journal du programme d’installation et les journaux d’installation MSI. Chaque tentative d’installation ou de suppression est enregistrée dans un dossier horodaté. Le titre du dossier indique le résultat de l’opération avec le préfixe PASS ou FAIL. Vous pouvez utiliser des outils de recherche de répertoire standard pour trouver une installation ou une suppression ayant échoué dans le partage de journaux central. Ces outils offrent une alternative à la recherche locale sur les machines cibles.

Avant de commencer toute installation, lisez et effectuez les tâches décrites dans Préparer l’installation.

Installer ou mettre à niveau des VDA à l’aide du script

  1. Obtenez l’exemple de script InstallVDA.bat à partir de \Support\AdDeploy\ sur le support d’installation. Citrix vous recommande de faire une sauvegarde du script original avant de le personnaliser.
  2. Modifiez le script :
    • Spécifiez la version du VDA à installer : SET DESIREDVERSION. La valeur complète se trouve sur le support d’installation dans le fichier ProductVersion.txt. Cependant, une correspondance exacte n’est pas requise.
    • Spécifiez le partage réseau où le programme d’installation sera invoqué. Pointez vers la racine de la disposition (le point le plus élevé de l’arborescence). La version appropriée du programme d’installation (32 bits ou 64 bits) est appelée automatiquement lorsque le script s’exécute. Par exemple : SET DEPLOYSHARE=\\fileserver1\share1.
    • Vous pouvez éventuellement spécifier un emplacement de partage réseau pour stocker les journaux centralisés. Par exemple : SET LOGSHARE=\\fileserver1\log1).
    • Spécifiez les options de configuration du VDA comme décrit dans Installer à l’aide de la ligne de commande. Les options /quiet et /noreboot sont incluses par défaut dans le script et sont requises : SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME.
  3. À l’aide des scripts de démarrage de stratégie de groupe, attribuez le script à l’unité d’organisation (OU) contenant vos machines. Cette unité d’organisation ne doit contenir que les machines sur lesquelles vous souhaitez installer le VDA. Lorsque les machines de cette unité d’organisation sont redémarrées, le script s’exécute sur toutes. Un VDA est installé sur chaque machine dotée d’un système d’exploitation pris en charge.

Supprimer des VDA à l’aide du script

  1. Obtenez l’exemple de script UninstallVDA.bat à partir de \Support\AdDeploy\ sur le support d’installation. Citrix vous recommande de faire une sauvegarde du script original avant de le personnaliser.
  2. Modifiez le script.
    • Spécifiez la version du VDA à supprimer : SET CHECK\_VDA\_VERSION. La valeur complète se trouve sur le support d’installation dans le fichier ProductVersion.txt (par exemple, 7.0.0.3018). Cependant, une correspondance exacte n’est pas requise.
    • Vous pouvez éventuellement spécifier un emplacement de partage réseau pour stocker les journaux centralisés.
  3. À l’aide des scripts de démarrage de stratégie de groupe, attribuez le script à l’unité d’organisation (OU) contenant vos machines. Cette unité d’organisation ne doit contenir que les machines desquelles vous souhaitez supprimer le VDA. Lorsque les machines de l’unité d’organisation sont redémarrées, le script s’exécute sur toutes. Le VDA est supprimé de chaque machine.

Dépannage

  • Le script génère des fichiers journaux internes qui décrivent la progression de l’exécution du script. Le script copie un journal Kickoff_VDA_Startup_Script vers le partage de journaux central quelques secondes après le début du déploiement. Vous pouvez vérifier que le processus global fonctionne. Si ce journal n’est pas copié vers le partage de journaux central comme prévu, effectuez un dépannage plus approfondi en inspectant la machine locale. Le script place deux fichiers journaux de débogage dans le dossier %temp% sur chaque machine :
    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log Examinez ces journaux pour vous assurer que le script :
    • S’exécute comme prévu.
    • Détecte correctement le système d’exploitation cible.
    • Est correctement configuré pour pointer vers la ROOT du partage DEPLOYSHARE (contient le fichier nommé AutoSelect.exe).
    • Est capable de s’authentifier auprès des partages DEPLOYSHARE et LOG.

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

  • Dans l’affichage Studio pour un groupe de mise à disposition, l’entrée Version VDA installée dans le volet Détails peut ne pas correspondre à la version installée sur les machines. L’affichage des programmes et fonctionnalités de la machine indique la version réelle du VDA.

  • Une fois qu’un VDA est 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 des VDA et comment résoudre les problèmes d’enregistrement, consultez Enregistrement des VDA.
Installer des VDA à l’aide de scripts
March 18, 2026
Contributeur: 
C
March 18, 2026
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.