Installer les VDA à l’aide de SCCM

Présentation

Microsoft Endpoint Configuration Manager, anciennement System Center Configuration Manager (SCCM), est un produit Windows qui permet la gestion, le déploiement et la sécurité des appareils et des applications au sein d’une entreprise.

Remarque :

L’article suivant décrit uniquement des recommandations basées sur la façon dont Citrix® a testé l’environnement. Vous pouvez personnaliser ces étapes en fonction de vos besoins. Citrix n’est pas responsable des mises à jour ou des ajustements nécessaires pour répondre aux besoins des clients.

Recommandations

• Pour déployer avec succès un Virtual Delivery Agent (VDA) à l’aide de SCCM ou d’outils de distribution de logiciels similaires, Citrix recommande d’utiliser (/fr-fr/citrix-virtual-apps-desktops/2503/install-configure/install-vdas/third-party-vda-deployment-methods/install-vdas-sccm#example-installation-sequence-using-sccm) l’installateur VDA en une séquence d’étapes.

• Citrix ne recommande pas d’utiliser l’utilitaire de nettoyage VDA dans le cadre d’une installation ou d’une mise à niveau de VDA. Utilisez l’utilitaire de nettoyage VDA uniquement dans le cas limité où l’installateur VDA a précédemment échoué.

Avant de commencer

Le nombre de redémarrages requis pendant l’installation du VDA dépend de l’environnement. Par exemple :

• Un redémarrage peut être nécessaire pour les mises à jour en attente ou les redémarrages suite à des installations logicielles antérieures.
• Des fichiers précédemment verrouillés par d’autres processus pourraient nécessiter des mises à jour, forçant un redémarrage supplémentaire.
• Certains composants facultatifs de l’installateur VDA (tels que Citrix Profile Management et Citrix Files) peuvent nécessiter un redémarrage.
• Lorsque vous mettez à niveau un VDA, la machine sur laquelle il est installé doit être en mode maintenance, sans sessions.
• Lorsqu’une installation de VDA s’exécute pour la première fois sur une machine, l’installateur VDA utilisé est copié sur cette machine. Pour plus d’informations sur l’installation du VDA, consultez (/fr-fr/citrix-virtual-apps-desktops/2503/install-configure/install-prepare#installers) [Installateurs].

Le Séquenceur de tâches SCCM gère tous les redémarrages requis.

Étapes clés pour déployer le VDA à l’aide de SCCM

Les étapes suivantes décrivent comment déployer le VDA à l’aide de SCCM sur la machine virtuelle.

1. Installer le VDA.
2. Créer une unité d’organisation (UO).
3. Vérifier les machines.
4. Utiliser le VDA pour distribuer du contenu.

Étape 1 : Installer le VDA

Après avoir identifié tous les prérequis, utilisez le Séquenceur de tâches SCCM pour effectuer les tâches suivantes :

1. Installez le VDA à partir d’une copie accessible du support d’installation ou de l’un des programmes d’installation autonomes du VDA :

   • VDAWorkstationSetup_XXXX.exe
   • VDAServerSetup_XXXX.exe
   • VDAWorkstationCoreSetup_XXXX.exe

   Pour plus d’informations sur les programmes d’installation du VDA, consultez Programmes d’installation.

   Remarque :

   Lorsque vous mettez à niveau un VDA, la machine sur laquelle il est installé doit être en mode maintenance, sans sessions.

2. Lorsqu’une installation de VDA s’exécute pour la première fois sur une machine, le programme d’installation du VDA utilisé est copié sur cette machine.
   • Lorsque vous utilisez un programme d’installation de VDA autre que VDAWorkstationCoreSetup_XXXX.exe, le programme d’installation du VDA est copié vers %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
   • Lorsque vous utilisez VDAWorkstationCoreSetup_XXXX.exe, le programme d’installation du VDA est copié vers %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.

3. L’emplacement du répertoire du programme d’installation du VDA est également stocké dans le registre HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.

4. Ajoutez les options de ligne de commande /NOREBOOT, /NORESUME et /QUIET à vos options de ligne de commande.

   • /QUIET : Ne pas afficher l’interface utilisateur pendant l’installation, afin que SCCM puisse contrôler le processus d’installation.
   • /NOREBOOT : Empêcher le programme d’installation du VDA de redémarrer automatiquement. SCCM déclenche les redémarrages si nécessaire.
   • /NORESUME : Généralement, lorsqu’un redémarrage est nécessaire pendant l’installation, le programme d’installation du VDA définit une clé de registre d’exécution unique (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Windows utilise cette clé pour ouvrir le programme d’installation du VDA lorsque la machine redémarre. C’est un problème pour SCCM, car SCCM ne peut pas surveiller l’installation et capturer le code de sortie.

Étape 2 : Créer une unité d’organisation (UO)

1. Créez deux machines virtuelles jointes au domaine que vous souhaitez ajouter à l’UO. Lorsque les machines virtuelles sont initialement créées, elles se trouvent dans le dossier Computers. Déplacez les machines virtuelles vers le dossier SCCM. Exemple : WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

   

2. Dans Microsoft Configuration Manager, accédez à \Administration\Overview\Hierarchy Configuration\Discovery Methods\.

3. Cliquez sur Active Directory System Discovery, puis cochez la case Enable Active Directory System Discovery pour activer la découverte automatique des machines virtuelles nouvellement créées.

4. Cliquez sur l’icône pour sélectionner de nouveaux conteneurs.

5. Dans la section Emplacement, ajoutez le Chemin où se trouvent vos machines virtuelles SCCM.

6. Accédez à \Administration\Overview\Site Configuration\Sites et cliquez avec le bouton droit sur le VDA SCCM.

7. Sélectionnez Paramètres d’installation du client > Installation push du client. La fenêtre Propriétés de l’installation push du client s’ouvre.

8. Une fois les machines virtuelles définies sur Enabled, vous pouvez voir la liste des machines virtuelles comme illustré dans les images suivantes.

   

   

9. Créez une collection de périphériques pour créer l’unité d’organisation (OU). Saisissez le Nom de la collection.

   

10. Suivez les instructions de l’assistant.

    

    L’unité d’organisation (OU) est créée.

    

11. Ajoutez les machines virtuelles créées à la collection de périphériques nouvellement créée.

    1. Cliquez avec le bouton droit sur la machine virtuelle. Sélectionnez Ajouter les éléments sélectionnés > Ajouter les éléments sélectionnés à une collection de périphériques existante.

       

    2. Dans la fenêtre Sélectionner la collection, sélectionnez le nom de l’appareil requis. Dans cet exemple, il s’agit de Devices-SCCM.

       

    Devices-SCCM est répertorié dans Ressources et conformité > Vue d’ensemble > Collections de périphériques.

    

12. Sélectionnez Installer le client sur le collecteur de périphériques.

    

13. Sélectionnez le site d’installation requis.

    

14. Suivez les instructions de l’assistant. L’Assistant d’installation du client Configuration Manager est terminé avec succès.

    

Pour des informations détaillées, consultez Gérer les collections dans la documentation Microsoft.

Étape 3 : Vérifier les machines

1. Sur la machine cliente, vérifiez que le client est installé en vérifiant si le processus CCMExec est en cours d’exécution.

   

2. Vérifiez si le client est en cours d’exécution pour les machines virtuelles sur SCCM.

Étape 4 : Utiliser le VDA pour distribuer du contenu

Les étapes suivantes décrivent comment vous pouvez utiliser le VDA déployé pour distribuer du contenu sur les machines virtuelles associées.

1. Créer un package

2. Distribuer du contenu

Créer un package

1. Pour créer un package, cliquez avec le bouton droit sur le VDA souhaité et cliquez sur Créer un package.

   

2. Spécifiez l’emplacement des fichiers source pour ce package en cliquant sur Parcourir.

   

3. Sélectionnez le type de package souhaité.

   

4. Saisissez le Nom du package et la Ligne de commande.

   

5. Cliquez sur Suivant.

   

Pour des informations détaillées, consultez la section Packages et programmes dans Configuration Manager de la documentation Microsoft.

Distribuer le contenu

1. Cliquez avec le bouton droit sur le nom du package que vous avez créé.

2. Sélectionnez Distribuer le contenu.

   

3. Dans la fenêtre Assistant de distribution de contenu, sélectionnez l’emplacement des fichiers source du package que vous avez créé. Dans cet exemple, il s’agit de 2019-SCCM. Cliquez sur Suivant.

   

4. Vérifiez que le package (dans cet exemple, Zodiac) est disponible pour le déploiement.

   

   L’image suivante illustre que le package est disponible pour le déploiement.

   

Pour des informations détaillées, consultez Déployer et gérer le contenu pour Configuration Manager dans la documentation Microsoft.

Exemple de séquence d’installation à l’aide de SCCM

L’exemple suivant montre la séquence d’installation.

1. Redémarrer l’ordinateur : Préparez la machine en la redémarrant.

   

2. Première tentative d’installation du VDA : Démarrer l’installation du VDA.

   1. Ajoutez les options /quiet, /noreboot et /noresume à vos options de ligne de commande.

   2. Exécutez le programme d’installation du VDA de votre choix (image locale ou l’un des programmes d’installation minimaux).

      

   3. SCCM doit capturer le code de retour.

      • Si le code de retour est 0 ou 8, l’installation est terminée et un redémarrage est nécessaire.

        

      • Si un code de retour est 3, redémarrez la machine, puis transférez le contrôle à Deuxième tentative d’installation du VDA.

        

3. Deuxième tentative d’installation du VDA : Poursuivre l’installation du VDA.

   1. Après la Première tentative d’installation du VDA, si le fichier %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml existe, l’installation n’est pas terminée et doit être poursuivie une fois le redémarrage terminé.

      

   2. Deuxième tentative d’installation du VDA se répète jusqu’à ce que le fichier %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml n’existe plus ou qu’un code de retour autre que 0 ou 8 soit renvoyé. Traitez tout autre code de retour comme une erreur, et DEUXIÈME TENTATIVE D’INSTALLATION DU VDA doit signaler une erreur et s’arrêter.

   3. Reprenez l’installation du VDA en exécutant le programme d’installation du VDA approprié (XenDesktopVdaSetup.exe dans la plupart des cas, ou XenDesktopRemotePCSetup.exe si VDAWorkstationCoreSetup_XXXX.exe a été utilisé) à partir du répertoire du fichier %programdata%\ Citrix\XenDesktopSetup\ sans paramètres de ligne de commande. (Le programme d’installation du VDA utilise les paramètres qu’il a enregistrés lors de la première exécution du programme d’installation.)

      Éditeur de séquence de tâches de mise à niveau(/fr-fr/citrix-virtual-apps-desktops/2503/media/upgrade-task-sequence-editor.png)

   4. Surveillez le code de retour de l’installeur VDA.

      • 0 ou 8 : Succès, installation terminée, redémarrage requis.

        Installation terminée avec succès(/fr-fr/citrix-virtual-apps-desktops/2503/media/success-installation-complete.png)

      • 3 : L’installation n’est pas terminée. Redémarrez la machine et répétez INSTALL VDA SECOND ATTEMPT jusqu’à ce que le fichier %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml n’existe plus ou jusqu’à ce qu’un 0 ou 8 soit renvoyé. Considérez tout autre code de retour comme une erreur, et INSTALL VDA SECOND ATTEMPT doit signaler une erreur et se terminer.

Pour plus d’informations sur les codes de retour, consultez codes de retour d’installation Citrix.

Exemples de commandes d’installation de VDA

Les options d’installation disponibles varient selon l’installeur utilisé. Consultez les articles suivants pour plus de détails sur les options de ligne de commande.

• Installer les VDA
• Installer à l’aide de la ligne de commande

Commandes d’installation pour l’Accès PC distant

• La commande suivante utilise l’installeur VDA de base pour session unique (VDAWorkstationCoreSetup.exe) :

  VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

• La commande suivante utilise l’installeur VDA complet pour session unique (VDAWorkstationSetup.exe) :

  VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

Commande d’installation pour VDI dédié

• La commande suivante utilise le programme d’installation VDA complet pour session unique (VDAWorkstationSetup.exe):

  VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot