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

Préparer l’installation

March 18, 2026
Contributeur: 
C

Le déploiement de Citrix Virtual Apps and Desktops™ commence par l’installation des composants suivants. Ce processus prépare la livraison d’applications et de bureaux aux utilisateurs au sein de votre pare-feu.

  • Un ou plusieurs Delivery Controller
  • Citrix Director
  • Citrix StoreFront™
  • Citrix License Server
  • Un ou plusieurs Citrix Virtual Delivery Agent (VDA)
  • Composants et technologies facultatifs tels que Universal Print Server, Federated Authentication Service et Self-Service Password Reset

Pour les utilisateurs extérieurs à votre pare-feu, installez et configurez un composant supplémentaire, tel que Citrix Gateway. Pour une introduction, consultez Intégrer Citrix Virtual Apps and Desktops à Citrix Gateway.

Remarque :

Assurez-vous que les prérequis Microsoft suivants sont remplis sur le système d’exploitation du serveur et le système d’exploitation du poste de travail :

Si votre déploiement inclut des charges de travail Windows Server, configurez un serveur de licences Microsoft RDS.

Vous pouvez utiliser le programme d’installation complet du produit sur l’ISO du produit pour déployer de nombreux composants et technologies. Vous pouvez utiliser un programme d’installation VDA autonome pour installer les VDA. Les programmes d’installation VDA autonomes sont disponibles sur le site de téléchargement de Citrix. Tous les programmes d’installation offrent des interfaces graphiques et en ligne de commande. Consultez Programmes d’installation.

L’ISO du produit contient des exemples de scripts qui installent, mettent à niveau ou suppriment des VDA pour les machines dans un Active Directory. Vous pouvez également utiliser les scripts pour gérer les images utilisées par Machine Creation Services (MCS) et Citrix Provisioning (anciennement Provisioning Services). Pour plus de détails, consultez Installer des VDA à l’aide de scripts.

Informations à consulter avant l’installation

  • Présentation technique : Pour vous familiariser avec le produit et ses composants.
  • Sécurité : Lors de la planification de votre environnement de déploiement.
  • Problèmes connus : Problèmes que vous pourriez rencontrer dans cette version.
  • Bases de données : Découvrez les bases de données système et comment les configurer. Lors de l’installation du Controller, vous pouvez installer SQL Server Express pour l’utiliser comme base de données de site. Vous configurez la plupart des informations de base de données lorsque vous créez un site, après avoir installé les composants principaux.
  • Accès PC distant : Si vous déployez un environnement qui permet à vos utilisateurs d’accéder à leurs machines physiques au bureau à distance.
  • Connexions et ressources : Si vous utilisez un hyperviseur ou un autre service pour héberger ou provisionner des machines virtuelles pour des applications et des bureaux. Vous pouvez configurer la première connexion lorsque vous créez un site (après avoir installé les composants principaux). Configurez votre environnement de virtualisation avant cela.
  • Microsoft System Center Configuration Manager : Si vous utilisez ConfigMgr pour gérer l’accès aux applications et aux bureaux, ou si vous utilisez la fonctionnalité Wake on LAN avec l’accès PC distant.
  • Connexions d’hôte de cloud public : Si vous disposez d’une licence Hybrid Rights, vous pouvez créer des connexions d’hôte au cloud public. Pour plus d’informations sur la licence Hybrid Rights, consultez Renouvellements des droits hybrides. Pour plus d’informations sur les droits du cloud public et les raisons de ce changement, consultez CTX270373.

Où installer les composants

Consultez la section Configuration système requise pour connaître les plates-formes, les systèmes d’exploitation et les versions pris en charge. Les prérequis des composants sont installés automatiquement, sauf indication contraire. Consultez la documentation de Citrix StoreFront et de Citrix License Server pour connaître leurs plates-formes et prérequis pris en charge.

Vous pouvez installer les composants principaux sur le même serveur ou sur des serveurs différents.

  • L’installation de tous les composants principaux sur un seul serveur peut fonctionner pour les déploiements d’évaluation, de test ou de petite production.
  • Pour tenir compte d’une future expansion, envisagez d’installer les composants sur des serveurs différents. Par exemple, l’installation de Studio sur une machine différente du serveur où vous avez installé le Controller vous permet de gérer le site à distance.

  • Pour la plupart des déploiements de production, l’installation des composants principaux sur des serveurs séparés est recommandée.

    Installez le Citrix License Server et les licences avant d’installer d’autres composants sur d’autres serveurs.

  • Pour installer un composant pris en charge sur un Server CoreOS (tel qu’un Delivery Controller), vous devez utiliser la ligne de commande. Ce type de système d’exploitation n’offre pas d’interface graphique, installez donc Studio et d’autres outils ailleurs, puis pointez-les vers le serveur Controller.

Vous pouvez installer à la fois un Delivery Controller™ et un VDA pour OS multi-session sur le même serveur. Lancez le programme d’installation et sélectionnez le Delivery Controller (ainsi que tout autre composant principal que vous souhaitez sur cette machine). Relancez ensuite le programme d’installation et sélectionnez le Virtual Delivery Agent pour OS multi-session.

Assurez-vous que chaque système d’exploitation dispose des dernières mises à jour.

Assurez-vous que toutes les machines ont des horloges système synchronisées. L’infrastructure Kerberos qui sécurise la communication entre les machines nécessite une synchronisation.

Avec les XenServers, l’état d’alimentation de la machine virtuelle peut apparaître comme inconnu même si elle semble enregistrée. Pour résoudre ce problème, modifiez la valeur de la clé de registre HostTime pour désactiver la synchronisation de l’heure avec l’hôte :

HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"

Conseil :

La valeur par défaut est HostTime="UTC". Modifiez cette valeur pour quelque chose d’autre que UTC, par exemple, Local. Cette modification désactive efficacement la synchronisation de l’heure avec l’hôte.

Des conseils d’optimisation pour les machines Windows 10 à session unique sont disponibles dans CTX216252.

Où NE PAS installer les composants :

  • N’installez aucun composant sur un contrôleur de domaine Active Directory.
  • L’installation d’un Controller sur un nœud dans une installation de clustering SQL Server, une installation de mise en miroir SQL Server ou sur un serveur exécutant Hyper-V n’est pas prise en charge.

Si vous tentez d’installer ou de mettre à niveau un VDA sur un système d’exploitation Windows que cette version du produit ne prend pas en charge, un message vous redirige vers un article décrivant les options.

Exigences en matière d’autorisations et d’Active Directory

Vous devez être un utilisateur de domaine et un administrateur local sur les machines où vous installez les composants.

Pour utiliser un programme d’installation VDA autonome, vous devez disposer de privilèges administratifs élevés ou utiliser Exécuter en tant qu’administrateur.

Configurez votre domaine Active Directory avant de commencer une installation.

  • Exigences système répertorie les niveaux fonctionnels Active Directory pris en charge. Joint à Active Directory contient plus d’informations.
  • Vous devez disposer d’au moins un contrôleur de domaine exécutant les services de domaine Active Directory.
  • N’installez aucun composant Citrix Virtual Apps™ and Desktops sur un contrôleur de domaine.
  • N’utilisez pas de barre oblique (/) lorsque vous spécifiez des noms d’unités d’organisation dans Studio.

Le compte d’utilisateur Windows utilisé pour installer le Citrix License Server est automatiquement configuré en tant qu’administrateur complet de l’administration déléguée.

Pour plus d’informations :

Conseils d’installation, considérations et bonnes pratiques

Lors de l’installation de tout composant

  • Lors de l’installation ou de la mise à niveau d’un Delivery Controller, de Studio, du License Server ou de Director à partir du support produit complet, si le programme d’installation Citrix détecte qu’un redémarrage est en attente suite à une installation Windows précédente sur la machine, le programme d’installation s’arrête avec le code de sortie/retour 9. Vous êtes invité à redémarrer la machine.

    Il ne s’agit pas d’un redémarrage forcé par Citrix. Cela est dû à d’autres composants installés précédemment sur la machine. Si cela se produit, redémarrez la machine, puis relancez le programme d’installation Citrix.

    Lorsque vous utilisez l’interface de ligne de commande, vous pouvez empêcher la vérification du redémarrage en attente en incluant l’option /no_pending_reboot_check dans la commande.

  • Généralement, si un composant a des prérequis, le programme d’installation les déploie s’ils ne sont pas présents. Certains prérequis peuvent nécessiter un redémarrage de la machine.

  • Lorsque vous créez des objets avant, pendant et après l’installation, spécifiez des noms uniques pour chaque objet. Par exemple, fournissez des noms uniques pour les réseaux, les groupes, les catalogues et les ressources.

  • Si un composant ne s’installe pas correctement, l’installation s’arrête avec un message d’erreur. Les composants installés avec succès sont conservés. Vous n’avez pas besoin de les réinstaller.

  • Les données Citrix Analytics sont collectées automatiquement lorsque vous installez (ou mettez à niveau) des composants. Par défaut, ces données sont automatiquement téléchargées vers Citrix une fois l’installation terminée. De plus, lorsque vous installez des composants, vous êtes automatiquement inscrit au programme Citrix Customer Experience Improvement Program (CEIP), qui télécharge des données anonymes.

    Lors de l’installation, vous pouvez également choisir de participer à d’autres technologies Citrix qui collectent des diagnostics pour la maintenance et le dépannage. Pour plus d’informations sur ces programmes, consultez Citrix Insight Services.

  • Les données Google Analytics sont collectées (puis téléchargées) automatiquement lorsque vous installez (ou mettez à niveau) Studio. Après l’installation de Studio, vous pouvez modifier ce paramètre avec la clé de registre HKLM\Software\Citrix\DesktopStudio\GAEnabled. Une valeur de 1 active la collecte et le téléchargement, 0 les désactive.

  • Si l’installation d’un VDA échoue, un analyseur MSI analyse le journal MSI défaillant, affichant le code d’erreur exact. L’analyseur suggère un article CTX, s’il s’agit d’un problème connu. L’analyseur collecte également des données anonymisées sur le code d’erreur de l’échec. Ces données sont incluses avec d’autres données collectées par le CEIP. Si vous mettez fin à votre inscription au CEIP, les données collectées par l’analyseur MSI ne sont plus envoyées à Citrix.

Pendant l’installation du VDA

  • L’application Citrix Workspace™ pour Windows est disponible, mais n’est pas installée par défaut lorsque vous installez un VDA. Vous ou vos utilisateurs pouvez télécharger et installer (et mettre à niveau) l’application Citrix Workspace pour Windows et d’autres applications Citrix Workspace depuis le site web de Citrix. Alternativement, vous pouvez rendre ces applications Citrix Workspace disponibles depuis votre serveur StoreFront. Consultez la documentation StoreFront.

  • Le service Spouleur d’impression Microsoft doit être activé. Vous ne pouvez pas installer un VDA avec succès si ce service est désactivé.

  • La plupart des éditions de Windows prises en charge sont livrées avec Microsoft Media Foundation déjà installé. Si la machine ne dispose pas de Media Foundation (comme les éditions N), plusieurs fonctionnalités multimédias ne sont pas installées et ne fonctionneront pas.

    • Redirection Windows Media
    • Redirection vidéo HTML5
    • Redirection de webcam HDX™ RealTime

    Vous pouvez reconnaître la limitation, ou mettre fin à l’installation du VDA et la redémarrer plus tard, après l’installation de Media Foundation. Dans l’interface graphique, ce choix est présenté dans un message. En ligne de commande, vous pouvez utiliser l’option /no_mediafoundation_ack pour reconnaître la limitation.

  • Lorsque vous installez le VDA, un nouveau groupe d’utilisateurs local appelé Utilisateurs d’accès direct est créé automatiquement. Sur un VDA pour OS à session unique, ce groupe s’applique uniquement aux connexions RDP. Sur un VDA pour OS multi-session, ce groupe s’applique aux connexions ICA® et RDP.

  • Le VDA doit disposer d’adresses de contrôleur valides avec lesquelles communiquer. Sinon, les sessions ne peuvent pas être établies. Vous pouvez spécifier les adresses de contrôleur lors de l’installation du VDA ou ultérieurement. N’oubliez pas que cela doit être fait. Pour plus d’informations, consultez Enregistrement du VDA.

Redémarrages après et pendant l’installation du VDA

Un redémarrage est requis à la fin de l’installation du VDA. Ce redémarrage se produit automatiquement par défaut.

Lorsque vous mettez à niveau un VDA vers la version 7.17 (ou une version ultérieure prise en charge), un redémarrage se produit pendant la mise à niveau. Cela ne peut pas être évité.

Pour minimiser le nombre de redémarrages nécessaires pendant l’installation du VDA :

  • Assurez-vous qu’une version prise en charge de .NET Framework est installée avant de commencer l’installation du VDA.
  • Pour les machines OS Windows multi-session, installez et activez les services de rôle RDS avant d’installer le VDA.

Si vous n’installez pas ces prérequis avant d’installer le VDA :

  • Si vous utilisez l’interface graphique ou l’interface de ligne de commande sans l’option /noreboot, la machine redémarre automatiquement après l’installation du prérequis.
  • Si vous utilisez l’interface de ligne de commande avec l’option /noreboot, vous devez initier le redémarrage.

Lorsque vous mettez à niveau une version de VDA, un redémarrage se produit pendant la mise à niveau. Cela ne peut pas être évité.

Restauration en cas d’échec d’installation ou de mise à niveau

Remarque :

Cette fonctionnalité est disponible pour les VDA à session unique et multi-session.

Si l’installation ou la mise à niveau d’un VDA à session unique échoue, et que la fonctionnalité de “restauration en cas d’échec” est activée, la machine est restaurée à un point de restauration qui a été défini avant le début de l’installation ou de la mise à niveau.

Si l’installation ou la mise à niveau d’un VDA multi-session échoue, et que la fonctionnalité de “restauration en cas d’échec” est activée, la machine est restaurée à une sauvegarde qui a été effectuée avant le début de l’installation ou de la mise à niveau.

Lorsqu’une installation ou une mise à niveau de VDA monosession démarre avec cette fonctionnalité activée, le programme d’installation crée un point de restauration du système avant de commencer l’installation ou la mise à niveau proprement dite. Si l’installation ou la mise à niveau du VDA échoue, la machine est restaurée à l’état du point de restauration. Le dossier %temp%/Citrix contient les journaux de déploiement et d’autres informations sur la restauration.

Lorsqu’une installation ou une mise à niveau de VDA multisession démarre avec cette fonctionnalité activée, le programme d’installation crée une sauvegarde du serveur avant de commencer l’installation ou la mise à niveau proprement dite. Si l’installation ou la mise à niveau du VDA échoue, la machine est restaurée à l’état de la sauvegarde. Le dossier %temp%/Citrix contient les journaux de déploiement et d’autres informations sur la restauration. Le temps nécessaire à la création de la sauvegarde du serveur dépend de la taille de la sauvegarde requise et de la quantité de ressources disponibles pour le serveur. La sauvegarde est stockée dans C:\WindowsImageBackup\servername.

Par défaut, cette fonctionnalité est désactivée.

Si vous prévoyez d’activer cette fonctionnalité, assurez-vous que la restauration du système n’est pas désactivée via un paramètre de GPO (Configuration ordinateur > Modèles d'administration > Système > Restauration du système).

Remarque :

Ce paramètre de GPO ne s’applique pas à la restauration d’un VDA multisession.

Pour activer cette fonctionnalité lors de l’installation ou de la mise à niveau d’un VDA monosession ou multisession :

  • Lorsque vous utilisez l’interface graphique d’un programme d’installation de VDA (par exemple, en utilisant Exécution automatique ou la commande XenDesktopVDASetup.exe sans aucune option de restauration ou silencieuse), cochez la case Activer la restauration automatique en cas d’échec de la mise à jour sur la page Résumé.

    Si l’installation/la mise à niveau se termine avec succès, le point de restauration/la sauvegarde n’est pas utilisé, mais est conservé.

  • Exécutez un programme d’installation de VDA avec l’option /enablerestore ou /enablerestorecleanup à l’aide de la ligne de commande.

    • Si vous utilisez l’option /enablerestorecleanup et que l’installation/la mise à niveau se termine avec succès, le point de restauration/la sauvegarde du serveur est automatiquement supprimé.

    • Si vous utilisez l’option /enablerestore et que l’installation/la mise à niveau se termine avec succès, le point de restauration n’est pas utilisé, mais est conservé.

Programmes d’installation

Programme d’installation complet du produit

À l’aide du programme d’installation complet du produit fourni dans l’ISO, vous pouvez :

  • Installer, mettre à niveau ou supprimer les composants principaux : Delivery Controller, Studio, Director et License Server.
  • Installer ou mettre à niveau StoreFront.
  • Installer ou mettre à niveau les VDA Windows pour les systèmes d’exploitation monosession ou multisession.
  • Installer le composant UpsServer du serveur d’impression universel sur vos serveurs d’impression.
  • Installer le service d’authentification fédérée.
  • Installer l’enregistrement de session.

  • Installer Workspace Environment Management.

    Remarque :

    Le programme d’installation de l’agent Workspace Environment Management™ n’est pas localisé. Il est disponible uniquement en anglais.

Pour fournir un bureau à partir d’un système d’exploitation multisession pour un seul utilisateur (par exemple, pour le développement Web), utilisez l’interface de ligne de commande du programme d’installation complet du produit. Pour plus de détails, consultez VDI de serveur.

Programmes d’installation de VDA autonomes

Les programmes d’installation de VDA autonomes sont disponibles sur les pages de téléchargement de Citrix. (Ils ne sont pas disponibles à partir du support d’installation du produit.) Les programmes d’installation de VDA autonomes sont beaucoup plus petits que l’ISO du produit complet. Ils s’adaptent plus facilement aux déploiements qui :

  • Utilisent des packages de distribution de logiciels électroniques (ESD) qui sont mis en scène ou copiés localement
  • Ont des machines physiques
  • Ont des bureaux distants

Par défaut, les fichiers des VDA autonomes auto-extractibles sont extraits dans le dossier Temp. Plus d’espace disque est requis sur la machine lors de l’extraction dans le dossier Temp que lors de l’utilisation du programme d’installation complet du produit. Cependant, les fichiers extraits dans le dossier Temp sont automatiquement supprimés une fois l’installation terminée. Alternativement, vous pouvez utiliser la commande /extract avec un chemin absolu.

Quatre programmes d’installation de VDA autonomes sont disponibles en téléchargement.

Agent de livraison virtuel (VDA) pour OS multi-session (VDAServerSetup.exe)

Installe un VDA pour OS multi-session. Il prend en charge toutes les options de VDA pour OS multi-session disponibles avec le programme d’installation complet du produit.

Agent de livraison virtuel (VDA) pour OS mono-session (VDAWorkstationSetup.exe)

Installe un VDA pour OS mono-session. Il prend en charge toutes les options de VDA pour OS mono-session disponibles avec le programme d’installation complet du produit.

Agent de livraison virtuel (VDA) pour services de base d’OS mono-session (VDAWorkstationCoreSetup.exe)

Installe un VDA pour OS mono-session optimisé pour les déploiements d’accès au PC distant ou les installations VDI de base. L’accès au PC distant utilise des machines physiques. Les installations VDI de base sont des machines virtuelles qui ne sont pas utilisées comme image. Il installe uniquement les services de base nécessaires aux connexions VDA pour de tels déploiements. Par conséquent, il ne prend en charge qu’un sous-ensemble des options valides avec les programmes d’installation complets du produit ou VDAWorkstationSetup.exe.

Ce programme d’installation n’installe ni ne contient les composants utilisés pour :

  • App-V.
  • Gestion des profils. L’exclusion de Citrix Profile Management de l’installation affecte l’affichage de Citrix Director. Pour plus de détails, consultez Installer des VDA.
  • Service d’identité de machine.
  • Citrix MCS IODriver
  • Citrix Backup and Restore
  • deviceTRUST
  • uberAgent
  • WEM

Le programme d’installation VDAWorkstationCoreSetup.exe n’installe ni ne contient les composants suivants : Citrix Workspace app pour Windows (CWA), Citrix Secure Access Client (CSA), Citrix User Personalization Layer (UPL), Session Recording Agent (SRAGENT) et Citrix Assistant App (ASSISTANTAPP).

L’utilisation de VDAWorkstationCoreSetup.exe équivaut à utiliser le programme d’installation complet du produit ou VDAWorkstationSetup pour installer un VDA pour OS mono-session et :

  • Dans l’interface graphique : Sélectionner l’option Accès au PC distant sur la page Environnement.
  • Dans l’interface de ligne de commande : Spécifier l’option /remotepc.
  • Dans l’interface de ligne de commande : Spécifier /components vda plus l’option /exclude qui liste tous les noms de composants supplémentaires valides.

Vous pouvez installer les composants/fonctionnalités omis ultérieurement en exécutant le programme d’installation complet du produit. Cette action vous permet d’installer tous les composants manquants.

Le programme d’installation VDAWorkstationCoreSetup.exe installe automatiquement le MSI de redirection de contenu de navigateur. Cette installation automatique s’applique à la version 2003 du VDA et aux versions ultérieures prises en charge.

Agent de livraison virtuel (VDA) pour services de base mono-session (VDASingleSessionCoreSetup.exe)

Un nouveau méta-programme d’installation VDA mono-session léger est disponible pour les déploiements Windows 365 Cloud PC et PC distant. Ce programme d’installation est basé sur le programme d’installation VDAWorkstationCoreSetup.exe existant, fournissant les composants VDA essentiels ainsi que Profile Management, deviceTRUST, uberAgent, WEM, Backup and Restore, et l’agent de mise à niveau VDA. La fonctionnalité Backup and Restore peut être activée à l’aide de l’option de ligne de commande /enablerestore ou /enablerestorecleanup.

Il réduit considérablement la taille du package et améliore la fiabilité de l’installation pour les charges de travail basées sur le cloud. Conçu pour les scénarios modernes de PC distant, ce programme d’installation offre une option simplifiée et haute performance pour le déploiement des charges de travail Citrix sur Windows 365 et PC distant.

Bonnes pratiques pour l’utilisation des programmes d’installation VDA mono-session

Pour les systèmes d’exploitation mono-session, quatre programmes d’installation différents sont disponibles. Le programme d’installation VDA complet du produit et le programme d’installation VDAWorkstationSetup.exe permettent l’installation de tous les composants, tandis que certains composants par défaut et supplémentaires ne sont pas inclus dans les programmes d’installation VDAWorkstationCoreSetup.exe et VDASingleSessionCoreSetup.exe.

Pour maintenir la stabilité de l’environnement, des performances constantes et une prise en charge continue, Citrix recommande d’utiliser un type de programme d’installation cohérent tout au long du cycle de vie d’un VDA Citrix, y compris l’installation, la mise à niveau et la désinstallation. Le mélange des types de programmes d’installation peut introduire certains risques.

Risques associés au mélange des types de programmes d’installation :

Scénario 1 : Si un VDA mono-session est initialement installé à l’aide du programme d’installation VDAWorkstationCoreSetup.exe ou VDASingleSessionCoreSetup.exe et est ensuite mis à niveau avec le programme d’installation VDA complet du produit ou le programme d’installation VDAWorkstationSetup.exe, les composants précédemment exclus peuvent être installés pendant la mise à niveau, à moins qu’ils ne soient spécifiquement exclus.

Scénario 2 : Si un VDA mono-session est initialement installé à l’aide du programme d’installation VDA complet du produit ou VDAWorkstationSetup.exe et est ensuite mis à niveau à l’aide de VDAWorkstationCoreSetup.exe ou VDASingleSessionCoreSetup.exe, tous les composants non installés par le programme d’installation VDA des services de base sont exclus de la mise à niveau. Ces composants ne sont ni mis à niveau pendant le processus de mise à niveau, ni supprimés lors de la désinstallation.

Scénario 3 : Si un VDA à session unique est initialement installé à l’aide de l’installeur VDAWorkstationCoreSetup.exe, puis mis à niveau avec VDASingleSessionCoreSetup.exe, vous bénéficierez des nouvelles fonctionnalités. Si vous effectuez la mise à niveau avec VDAWorkstationCoreSetup.exe la prochaine fois, les composants nouvellement ajoutés par VDASingleSessionCoreSetup.exe ne seront ni mis à niveau pendant le processus de mise à niveau, ni supprimés lors de la désinstallation.

Conseils pour gérer les types d’installeurs mixtes :

S’il devient nécessaire de mélanger les types d’installeurs, il est essentiel de s’assurer que les mêmes composants sont inclus pendant le processus de mise à niveau.

Dans les cas où les types d’installeurs ont été mélangés par inadvertance, entraînant l’installation de composants supplémentaires ou la perte de gestion de certains composants, et qu’il est nécessaire de restaurer l’environnement précédent, procédez comme suit :

  • Pour le scénario 1 : Désinstallez le VDA à partir de la fonctionnalité Windows de désinstallation ou de modification de programmes, puis réinstallez le VDA à l’aide de l’installeur que vous avez utilisé à l’origine (VDAWorkstationCoreSetup.exe ou VDASingleSessionCoreSetup.exe).

  • Pour le scénario 2 : Mettez à niveau les composants manquants à l’aide de l’installeur VDA complet ou de l’installeur VDAWorkstationSetup.exe.

  • Pour le scénario 3 : Si vous souhaitez continuer à tirer parti des nouvelles fonctionnalités, mettez à niveau les composants manquants à l’aide de l’installeur VDASingleSessionCoreSetup.exe. Alternativement, si vous préférez ne pas utiliser les nouvelles fonctionnalités après la mise à niveau avec VDASingleSessionCoreSetup.exe, désinstallez d’abord le VDA à partir de la fonctionnalité Windows de désinstallation ou de modification de programmes, puis réinstallez le VDA à l’aide de VDAWorkstationCoreSetup.exe.

Codes de retour d’installation Citrix

Le journal d’installation contient le résultat des installations de composants sous forme de code de retour Citrix, et non de valeur Microsoft.

  • 0 = Succès
  • 1 = Échec
  • 2 = SuccèsPartiel
  • 3 = SuccèsPartielEtRedémarrageNécessaire
  • 4 = ÉchecEtRedémarrageNécessaire
  • 5 = AnnuléParL’Utilisateur
  • 6 = ArgumentDeLigneDeCommandeIncorrect
  • 7 = VersionPlusRécenteTrouvée
  • 8 = SuccèsRedémarrageNécessaire
  • 9 = RedémarrageVerrouillageFichier
  • 10 = Abandonné
  • 11 = MédiaÉchoué
  • 12 = LicenceÉchouée
  • 13 = Pré-vérificationÉchouée
  • 14 = AbandonnéVérificationRedémarrageEnAttente
  • 15 = Pré-vérificationRéussie - Ceci est renvoyé lorsque les pré-vérifications réussissent après l’utilisation de la nouvelle option de ligne de commande /precheckonly.
  • 16 = Pré-vérificationÉchouée - Ceci est renvoyé lorsque les pré-vérifications échouent après l’utilisation de la nouvelle option de ligne de commande /precheckonly.
  • 17 = LogicielFacultatifÉchoué - Ceci est renvoyé lorsqu’un des nouveaux composants logiciels facultatifs ne s’installe pas et que l’option « Poursuivre l’installation ou la mise à niveau du VDA si d’autres composants sélectionnés échouent. » a été sélectionnée.

Par exemple, lors de l’utilisation d’outils tels que Microsoft System Center Configuration Manager, une installation de VDA scriptée peut sembler échouer lorsque le journal d’installation contient le code de retour 3. Cela peut se produire lorsque l’installeur VDA attend un redémarrage que vous devez initier (par exemple, après l’installation d’un prérequis de rôle RDS sur un serveur). Une installation de VDA est considérée comme réussie uniquement après l’installation de tous les prérequis et composants sélectionnés, et le redémarrage de la machine après l’installation.

Alternativement, vous pouvez encapsuler votre installation dans des scripts CMD (qui renvoient des codes de sortie Microsoft) ou modifier les codes de succès dans votre package Configuration Manager.

Configurer un serveur de licences Microsoft RDS pour les charges de travail Windows Server

Ce produit accède aux capacités de session à distance de Windows Server lors de la livraison d’une charge de travail Windows Server, telle que Windows 2016. Cela nécessite généralement une licence d’accès client (CAL) Remote Desktop Services (RDS). Le VDA doit pouvoir contacter un serveur de licences RDS pour demander des CAL RDS. Installez et activez le serveur de licences. Pour plus d’informations, consultez le document Microsoft Activer le serveur de licences Remote Desktop Services. Pour les environnements de preuve de concept, vous pouvez utiliser la période de grâce fournie par Microsoft.

Avec cette méthode, vous pouvez faire en sorte que ce service applique les paramètres du serveur de licences. Vous pouvez configurer le serveur de licences et le mode par utilisateur dans la console RDS sur l’image. Vous pouvez également configurer le serveur de licences à l’aide des paramètres de stratégie de groupe Microsoft. Pour plus d’informations, consultez le document Microsoft Licencier votre déploiement RDS avec des licences d’accès client (CAL).

Pour configurer le serveur de licences RDS à l’aide des paramètres de stratégie de groupe :

  1. Installez un serveur de licences Remote Desktop Services sur une machine disponible. La machine doit toujours être disponible. Les charges de travail des produits Citrix doivent pouvoir atteindre ce serveur de licences.
  2. Spécifiez l’adresse du serveur de licences et le mode de licence par utilisateur à l’aide de la stratégie de groupe Microsoft. Pour plus de détails, consultez le document Microsoft Spécifier le mode de licence des services Bureau à distance pour un serveur hôte de session Bureau à distance.

Les charges de travail Windows 10 nécessitent une activation de licence Windows 10 appropriée. Nous vous recommandons de suivre la documentation Microsoft pour activer les charges de travail Windows 10.

Plus d’informations

Pour la configuration de l’emplacement des ressources pour des types d’hôtes spécifiques :

Préparer l’installation
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.