Gérer les catalogues de machines

Remarque :

À partir de la version 2511, Citrix Web Studio (basé sur le Web) est la seule console de gestion pour Citrix Virtual Apps and Desktops™. Citrix Studio (basé sur MMC) a été supprimé de l’installateur. Cet article s’applique uniquement à Web Studio. Pour plus d’informations sur Citrix Studio, consultez l’article équivalent dans Citrix Virtual Apps and Desktops 7 2212 ou une version antérieure.

Introduction

Vous pouvez ajouter ou supprimer des machines d’un catalogue de machines, renommer, modifier la description ou gérer les comptes d’ordinateur Active Directory d’un catalogue.

La maintenance des catalogues peut également inclure la vérification que chaque machine dispose des dernières mises à jour du système d’exploitation. Cela inclut les mises à jour antivirus, les mises à niveau du système d’exploitation ou les modifications de configuration.

• Les catalogues contenant des machines aléatoires en pool créées à l’aide de Machine Creation Services™ (MCS) maintiennent les machines en mettant à jour l’image principale utilisée dans le catalogue, puis en mettant à jour les machines. Cette méthode vous permet de mettre à jour efficacement un grand nombre de machines utilisateur.
• Pour les catalogues contenant des machines statiques, attribuées de manière permanente, et pour les catalogues de machines d’accès PC à distance, vous gérez les mises à jour des machines utilisateur en dehors de Web Studio. Effectuez cette tâche individuellement ou collectivement à l’aide d’outils de distribution de logiciels tiers.

Pour plus d’informations sur la création et la gestion des connexions aux hyperviseurs hôtes, consultez Connexions et ressources.

Remarque :

MCS ne prend pas en charge Windows 10 IoT Core et Windows 10 IoT Enterprise. Reportez-vous au site Microsoft pour plus d’informations.

À propos des instances persistantes

Lors de la mise à jour d’un catalogue MCS créé à l’aide d’instances persistantes ou dédiées, toutes les nouvelles machines créées pour le catalogue utilisent l’image mise à jour. Les instances préexistantes continuent d’utiliser l’instance d’origine. Le processus de mise à jour d’une image est effectué de la même manière pour tout autre type de catalogue. Tenez compte des points suivants :

• Avec les catalogues de disques persistants, les machines préexistantes ne sont pas mises à jour vers la nouvelle image, mais toutes les nouvelles machines ajoutées au catalogue utilisent la nouvelle image.
• Pour les catalogues de disques non persistants, l’image de la machine est mise à jour la prochaine fois que la machine est réinitialisée.
• Avec les catalogues de machines persistantes, la mise à jour de l’image met également à jour les instances de catalogue qui l’utilisent.
• Pour les catalogues qui ne sont pas persistants, si vous souhaitez des images différentes pour différentes machines, les images doivent résider dans des catalogues distincts.

Gérer les catalogues de machines

Vous pouvez gérer un catalogue de machines de deux manières :

• Utilisation de Web Studio
• Utilisation de PowerShell

Utiliser Web Studio

Cette section détaille comment vous pouvez gérer les catalogues à l’aide de Web Studio :

• Gérer les catalogues de machines
  • Introduction
  • À propos des instances persistantes
• Gérer les catalogues de machines
• Utiliser Web Studio
• Afficher les détails du catalogue
  • Ajouter des machines à un catalogue
  • Supprimer des machines d’un catalogue
• Modifier un catalogue
• Renommer un catalogue
• Déplacer un catalogue vers une autre zone
• Supprimer un catalogue
• Convertir les catalogues MCS hérités dans Azure en catalogues basés sur des profils de machine
• Gérer les comptes d’ordinateur Active Directory dans un catalogue
• Mettre à jour un catalogue
  • Mettre à jour ou créer une image principale
  • Modifier l’image principale
  • Restaurer l’image principale
• Modifier le niveau fonctionnel ou annuler la modification
• Cloner un catalogue
• Organiser les catalogues à l’aide de dossiers
  • Créer un dossier de catalogue
  • Déplacer un catalogue
  • Gérer les dossiers de catalogue
• Mettre à niveau les VDA
• Réessayer la création du catalogue
• Inscrire des VDA non provisionnés par MCS à l’aide de jetons
• Utiliser PowerShell
• Récupérer les avertissements et les erreurs associés à un catalogue
• Ajouter des descriptions à une image
• Réinitialiser le disque du système d’exploitation
• Modifier le paramètre réseau d’un schéma de provisionnement existant
• Gérer les versions d’un catalogue de machines
• Convertir un catalogue de machines non basé sur un profil de machine en catalogue de machines basé sur un profil de machine
• Réparer les informations d’identité des comptes d’ordinateur actifs
  • Conditions
  • Réinitialiser le disque d’identité
• Modifier la configuration du cache sur un catalogue de machines existant
  • Exigences
  • Modifier la configuration du cache
• Prise en charge de la mise à jour des VDA via l’accès au partage de fichiers local
  • Cmdlets PowerShell
  • Prérequis
  • Comment définir les autorisations de partage de fichiers
  • Mises à jour des VDA à partir d’un partage de fichiers local
• Dépannage
• Étapes suivantes

Afficher les détails du catalogue

1. Utilisez la fonction de recherche pour localiser un catalogue de machines spécifique. Reportez-vous à Rechercher des instances pour obtenir des instructions.
2. Dans les résultats de la recherche, sélectionnez un catalogue si nécessaire.
3. Reportez-vous au tableau suivant pour les descriptions des colonnes du catalogue.
4. Reportez-vous au tableau suivant pour les descriptions des colonnes du catalogue.

1. Cliquez sur un onglet dans le volet de détails inférieur pour plus d’informations sur un catalogue sélectionné.

Ajouter des machines à un catalogue

Avant de commencer :

• Assurez-vous que l’hôte de virtualisation dispose de suffisamment de processeurs, de mémoire et de stockage pour accueillir les machines supplémentaires.
• Assurez-vous de disposer de suffisamment de comptes d’ordinateur Active Directory inutilisés. Si vous utilisez des comptes existants, le nombre de machines que vous pouvez ajouter est limité par le nombre de comptes disponibles.
• Si vous utilisez Web Studio pour créer des comptes d’ordinateur Active Directory pour les machines supplémentaires, vous devez disposer des autorisations d’administrateur de domaine appropriées.

Pour ajouter des machines à un catalogue :

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue de machines, puis sélectionnez Ajouter des machines dans la barre d’actions.
4. Sélectionnez le nombre de machines virtuelles à ajouter.
5. S’il n’y a pas suffisamment de comptes Active Directory existants pour le nombre de machines virtuelles que vous ajoutez, sélectionnez le domaine et l’emplacement où les comptes sont créés. Spécifiez un schéma de nommage de compte, en utilisant des dièses pour indiquer où les numéros ou lettres séquentiels apparaissent. N’utilisez pas de barre oblique (/) dans un nom d’unité d’organisation (OU). Un nom ne peut pas commencer par un chiffre. Par exemple, un schéma de nommage de PC-Sales-## (avec 0-9 sélectionné) génère des comptes d’ordinateur nommés PC-Sales-01, PC-Sales-02, PC-Sales-03, etc.
6. Si vous utilisez des comptes Active Directory existants, parcourez les comptes ou cliquez sur Importer et spécifiez un fichier .csv contenant les noms de compte. Assurez-vous qu’il y a suffisamment de comptes pour toutes les machines que vous ajoutez. Web Studio gère ces comptes. Autorisez Web Studio à réinitialiser les mots de passe de tous les comptes, ou spécifiez le mot de passe du compte, qui doit être le même pour tous les comptes.

Les machines sont créées en arrière-plan et la création de nombreuses machines peut prendre beaucoup de temps. La création de machines se poursuit même si vous fermez Web Studio.

Supprimer des machines d’un catalogue

Après avoir supprimé une machine d’un catalogue de machines, les utilisateurs ne peuvent plus y accéder. Par conséquent, avant de supprimer une machine, assurez-vous que :

• Les données utilisateur sont sauvegardées ou ne sont plus requises.
• Tous les utilisateurs sont déconnectés. L’activation du mode maintenance empêche l’établissement de nouvelles connexions à une machine.
• Les machines sont hors tension.

Pour supprimer des machines d’un catalogue :

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Afficher les machines dans la barre d’actions.
4. Sélectionnez une ou plusieurs machines, puis sélectionnez Supprimer dans la barre d’actions.

Choisissez si vous souhaitez supprimer les machines en cours de suppression. Si vous choisissez de supprimer les machines, indiquez si les comptes Active Directory de ces machines doivent être conservés, désactivés ou supprimés.

Modifier un catalogue

1. Sur la page Description, modifiez la description du catalogue.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Modifier le catalogue de machines dans la barre d’actions.
4. Sur la page Étendues, modifiez les étendues.

5. Sur la page Cartes réseau, effectuez les actions suivantes :

   • Pour modifier le mappage de sous-réseau d’une carte réseau, sélectionnez un réseau dans le champ Réseau associé.
   • Pour ajouter un mappage de sous-réseau, sélectionnez Ajouter une carte réseau, sélectionnez un réseau dans le champ Réseau associé, puis cliquez sur Enregistrer.

   Seuls les sous-réseaux présents dans l’hôte associé au catalogue apparaissent dans le champ Réseau associé.

   Vous ne pouvez ajouter des cartes réseau qu’aux catalogues de machines Azure sans profils de machines.

   Remarque :

   • Pour les catalogues de machines AWS, vous ne pouvez pas mapper le même sous-réseau à plusieurs cartes réseau.
   • Pour les catalogues de machines avec des profils de machines, le nombre de cartes réseau sur le catalogue doit être égal au nombre de cartes réseau sur le profil de machine.
   • Cette fonctionnalité n’est pas prise en charge pour les hyperviseurs IBM Cloud.
   • Cette fonctionnalité est prise en charge uniquement pour Nutanix Prism Element dans le cas des hyperviseurs Nutanix.

6. Vous pouvez voir d’autres pages en fonction du type de catalogue.

   Pour les catalogues créés à l’aide d’une image Azure Resource Manager, les pages suivantes sont visibles. Gardez à l’esprit que les modifications que vous apportez s’appliquent uniquement aux machines que vous ajoutez au catalogue ultérieurement. Les machines existantes restent inchangées.

   • Sur la page Machines virtuelles, modifiez la taille de la machine et les zones de disponibilité où vous souhaitez créer des machines.

     Remarque :

     • Seules les tailles de machines prises en charge par le catalogue sont affichées.
     • Si nécessaire, sélectionnez Afficher uniquement les tailles de machines utilisées dans d’autres catalogues de machines pour filtrer la liste des tailles de machines.
     • Pour les catalogues Azure, si ZRS est la Redondance du stockage sur la page Types de stockage et de licence, un avertissement vous suggère de désélectionner la zone et de laisser Azure gérer les zones de disponibilité des machines virtuelles.

   • Sur la page Profil de machine, choisissez d’utiliser ou de modifier un profil de machine.

     Remarque :

     Pour les catalogues Azure, lorsque vous modifiez un profil de machine qui inclut des zones de disponibilité et choisissez ZRS pour la redondance du stockage, un avertissement vous suggère de désélectionner la zone.

   • (Visible uniquement lorsque le catalogue est configuré avec un groupe d’hôtes dédié) Sur la page Groupe d’hôtes dédié, choisissez de modifier un groupe d’hôtes.

   • Sur la page Types de stockage et de licence, choisissez de modifier le type de redondance du stockage (pour le catalogue Azure), le type de stockage, le type de licence et les paramètres de la Galerie de calcul Azure (disponibles uniquement lorsque Placer l’image préparée dans la Galerie Azure est utilisé).

   Remarque :

   Si le paramètre nouvellement sélectionné ne prend pas en charge la taille de machine actuelle, une boîte de dialogue d’avertissement apparaît, vous informant que la modification du paramètre réinitialise le paramètre de taille de machine. Si vous choisissez de continuer, un point rouge apparaît à côté du menu Machines virtuelles, vous invitant à sélectionner une nouvelle taille de machine.

   • Sur la page Type de licence, choisissez de modifier le paramètre de licence Windows ou de licence Linux.

   Pour les catalogues d’accès PC distant, les pages suivantes sont visibles :

   • Sur la page Gestion de l’alimentation, modifiez les paramètres de gestion de l’alimentation et sélectionnez une connexion de gestion de l’alimentation.
   • Sur la page Unités d’organisation, ajoutez ou supprimez des unités d’organisation Active Directory.
7. Cliquez sur Appliquer pour appliquer les modifications que vous avez apportées, puis cliquez sur Enregistrer pour quitter.

Renommer un catalogue

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Renommer le catalogue de machines dans la barre d’actions.
4. Entrez le nouveau nom.

Déplacer un catalogue vers une autre zone

Si votre déploiement comporte plusieurs zones, vous pouvez déplacer un catalogue d’une zone à une autre.

Le déplacement d’un catalogue vers une zone différente de celle de l’hyperviseur contenant les machines virtuelles de ce catalogue affecte les performances.

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Déplacer dans la barre d’actions.
4. Sélectionnez la zone vers laquelle vous souhaitez déplacer le catalogue.

Supprimer un catalogue

Avant de supprimer un catalogue, assurez-vous que :

• Tous les utilisateurs sont déconnectés et qu’aucune session déconnectée n’est en cours d’exécution.
• Le mode maintenance est activé pour toutes les machines du catalogue afin que de nouvelles connexions ne puissent pas être établies.
• Toutes les machines du catalogue sont hors tension.
• Le catalogue n’est pas associé à un groupe de mise à disposition. En d’autres termes, le groupe de mise à disposition ne contient pas de machines du catalogue.

Pour supprimer un catalogue :

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Supprimer le catalogue de machines dans la barre d’actions.
4. Indiquez si les machines du catalogue sont supprimées. Si vous choisissez de supprimer les machines, indiquez si les comptes d’ordinateur Active Directory pour ces machines sont conservés, désactivés ou supprimés.

Convertir les catalogues MCS hérités dans Azure en catalogues basés sur un profil de machine

Pour convertir un catalogue de machines non basé sur un profil de machine en un catalogue de machines basé sur un profil de machine, suivez les étapes suivantes :

1. Sur la page Catalogues de machines, cliquez avec le bouton droit sur le nom du Catalogue de machines que vous souhaitez convertir, puis sélectionnez Modifier le catalogue de machines.
2. Sur la page Modifier le catalogue de machines > Profil de machine, cochez la case Utiliser un profil de machine (obligatoire pour Microsoft Entra ID).
3. Cliquez sur Sélectionner un profil de machine.
4. Sur la page Sélectionner un profil de machine, sélectionnez une machine virtuelle ou un modèle de lancement à utiliser comme profil de machine.
5. Si certains paramètres actuels diffèrent des nouveaux paramètres de profil de machine, sélectionnez l’option requise pour les paramètres que vous souhaitez utiliser et cliquez sur Continuer.
6. Cliquez sur Appliquer.

Remarque :

Actuellement, cette fonctionnalité est prise en charge uniquement pour Azure, AWS et VMware.

Gérer les comptes d’ordinateur Active Directory dans un catalogue

Pour gérer les comptes Active Directory dans un catalogue de machines, vous pouvez :

• Libérer les comptes de machine inutilisés en supprimant les comptes d’ordinateur Active Directory des catalogues de systèmes d’exploitation à session unique et à sessions multiples. Ces comptes peuvent ensuite être utilisés pour d’autres machines.
• Ajouter des comptes afin que, lorsque d’autres machines sont ajoutées au catalogue, les comptes d’ordinateur soient déjà en place. N’utilisez pas de barre oblique (/) dans un nom d’unité d’organisation.

Pour gérer les comptes Active Directory :

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Gérer les comptes AD dans la barre d’actions.

4. Choisissez d’ajouter ou de supprimer des comptes d’ordinateur. Si vous ajoutez des comptes, spécifiez ce qu’il faut faire avec les mots de passe des comptes : soit les réinitialiser tous, soit saisir un mot de passe qui s’applique à tous les comptes.

   Vous pouvez réinitialiser les mots de passe si vous ne connaissez pas les mots de passe actuels des comptes ; vous devez avoir l’autorisation d’effectuer une réinitialisation de mot de passe. Lors de la saisie d’un mot de passe, le mot de passe est modifié sur les comptes au fur et à mesure de leur importation. Lors de la suppression d’un compte, choisissez si le compte dans Active Directory est conservé, désactivé ou supprimé.

Indiquez si les comptes Active Directory sont conservés, désactivés ou supprimés lorsque vous supprimez des machines d’un catalogue ou supprimez un catalogue.

Mettre à jour un catalogue

Nous vous recommandons de sauvegarder des copies ou des instantanés des images principales avant de mettre à jour les machines du catalogue. La base de données conserve un historique des images principales utilisées avec chaque catalogue de machines. Rétablissez, ou annulez, les machines d’un catalogue pour utiliser la version précédente de l’image principale. Effectuez cette tâche si les utilisateurs rencontrent des problèmes avec les mises à jour que vous avez déployées sur leurs bureaux. Cela minimise les temps d’arrêt des utilisateurs. Ne supprimez pas, ne déplacez pas et ne renommez pas les images principales. Vous ne pouvez pas rétablir un catalogue pour les utiliser.

Après la mise à jour d’une machine, celle-ci redémarre automatiquement.

Mettre à jour ou créer une image principale

Avant de mettre à jour le catalogue de machines, mettez à jour une image principale existante ou créez-en une sur votre hyperviseur hôte.

1. Sur votre hyperviseur, prenez un instantané de la machine virtuelle actuelle et donnez-lui un nom significatif. Cet instantané peut être utilisé pour rétablir (annuler) les machines du catalogue, si nécessaire.
2. Si nécessaire, mettez sous tension l’image principale et connectez-vous.
3. Installez les mises à jour ou apportez les modifications requises à l’image principale.
4. Mettez la machine virtuelle hors tension.
5. Prenez un instantané de la machine virtuelle. Donnez-lui un nom significatif qui sera reconnu lors de la mise à jour du catalogue dans Web Studio. Bien que Web Studio puisse créer un instantané, Citrix vous recommande de le créer à l’aide de la console de gestion de l’hyperviseur. Sélectionnez ensuite cet instantané dans Web Studio. Ce processus vous permet de fournir un nom et une description significatifs plutôt qu’un nom généré automatiquement. Pour les images principales GPU, vous ne pouvez modifier l’image principale que via la console XenServer®.

Modifier l’image principale

Pour préparer et déployer la mise à jour sur toutes les machines d’un catalogue :

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez un catalogue, puis sélectionnez Modifier l’image principale dans la barre d’actions.
4. Sur la page Image, sélectionnez l’hôte et l’image que vous souhaitez déployer.

   Conseil :

   Pour un catalogue créé par MCS, vous pouvez annoter son image en ajoutant une note pour l’image. Une note peut contenir jusqu’à 500 caractères. Chaque fois que vous modifiez l’image principale, une entrée liée à la note est créée, que vous ajoutiez une note ou non. Si vous mettez à jour un catalogue sans ajouter de note, l’entrée apparaît comme nulle (-). Pour afficher l’historique des notes de l’image, sélectionnez le catalogue, cliquez sur Propriétés du modèle dans le volet inférieur, puis cliquez sur Afficher l’historique des notes.

5. Sur la page Stratégie de déploiement, choisissez le moment où les machines du catalogue de machines sont mises à jour avec la nouvelle image principale : lors du prochain arrêt ou immédiatement.

   Remarque :

   La page Stratégie de déploiement n’est pas disponible pour les machines virtuelles persistantes, car le déploiement ne s’applique qu’aux machines virtuelles non persistantes.

6. Vérifiez les informations sur la page Résumé, puis cliquez sur Terminer. Chaque machine redémarre automatiquement après sa mise à jour.

Pour suivre la progression de la mise à jour, localisez le catalogue dans Catalogues de machines pour afficher la barre de progression en ligne et le graphique de progression étape par étape.

Lors de la mise à jour d’un catalogue directement à l’aide du SDK PowerShell, plutôt que de Web Studio, spécifiez un modèle d’hyperviseur (VMTemplates). Utilisez-le comme alternative à une image ou à un instantané d’une image.

Pour déployer une nouvelle image principale sur un catalogue de machines basé sur Azure :

1. Depuis Web Studio, sélectionnez Catalogues de machines dans le volet gauche.
2. Sélectionnez un catalogue Azure, puis sélectionnez Modifier l’image principale dans la barre d’actions.
3. Sur la page Modifier l’image principale, sélectionnez une image sous Image principale. Le panneau répertorie toutes les images qui appartiennent à la même région que celles des ressources.

Stratégie de déploiement :

La mise à jour des images lors du prochain arrêt affectera immédiatement toutes les machines non utilisées actuellement, c’est-à-dire les machines qui n’ont pas de session utilisateur active. Un système en cours d’utilisation reçoit la mise à jour lorsque la session active en cours se termine. Tenez compte des éléments suivants :

• Les nouvelles sessions ne peuvent pas être lancées tant que la mise à jour n’est pas terminée sur les machines applicables.
• Pour les machines à OS mono-session, les machines sont immédiatement mises à jour lorsqu’elles ne sont pas utilisées ou lorsque les utilisateurs ne sont pas connectés.
• Pour un OS multi-session avec des machines enfants, les redémarrages ne se produisent pas automatiquement. Pour appliquer l’image maître mise à jour, redémarrez les machines à l’aide de Studio, PowerShell ou Workspace. Le redémarrage depuis les machines ou l’hyperviseur n’applique pas la mise à jour.

Conseil :

Limitez le nombre de machines redémarrées en utilisant les paramètres avancés d’une connexion d’hôte. Utilisez ces paramètres pour modifier les actions entreprises pour un catalogue donné ; les paramètres avancés varient en fonction de l’hyperviseur.

Annuler le déploiement de l’image maître

Après avoir déployé une image maître mise à jour ou nouvelle, vous pouvez annuler son déploiement. Ce processus peut être nécessaire si des problèmes surviennent avec les machines récemment mises à jour. Lorsque vous annulez le déploiement, les machines du catalogue sont restaurées à la dernière image fonctionnelle. Toutes les nouvelles fonctionnalités qui nécessitent l’image plus récente ne sont plus disponibles. Comme pour le déploiement, l’annulation du déploiement d’une machine inclut un redémarrage.

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez le catalogue, puis sélectionnez Annuler le déploiement de l’image maître dans la barre d’actions.
4. Spécifiez quand appliquer l’image maître précédente aux machines, comme décrit dans la section précédente pour l’opération de déploiement.

L’annulation du déploiement est appliquée uniquement aux machines qui doivent être restaurées. Les machines qui ne sont pas mises à jour avec la nouvelle image maître ou l’image maître mise à jour ne reçoivent pas de messages de notification et ne sont pas forcées de se déconnecter.

Pour suivre la progression de l’annulation du déploiement, localisez le catalogue dans Catalogues de machines pour afficher la barre de progression intégrée et le graphique de progression étape par étape.

Modifier le niveau fonctionnel ou annuler la modification

Modifiez le niveau fonctionnel du catalogue de machines après avoir mis à niveau les VDA sur les machines vers une version plus récente. Citrix recommande de mettre à niveau tous les VDA vers la dernière version pour permettre l’accès à toutes les nouvelles fonctionnalités.

Avant de modifier le niveau fonctionnel d’un catalogue de machines :

• Démarrez les machines mises à niveau afin qu’elles s’enregistrent auprès du Controller. Ce processus permet à Web Studio de déterminer que les machines du catalogue nécessitent une mise à niveau.

Pour modifier le niveau fonctionnel d’un catalogue :

1. Connectez-vous à Web Studio.
2. Sélectionnez Catalogues de machines dans le volet gauche.
3. Sélectionnez le catalogue. L’onglet Détails dans le volet inférieur affiche les informations de version.
4. Sélectionnez Modifier le niveau fonctionnel. Si Web Studio détecte que le catalogue nécessite une mise à niveau, un message s’affiche. Suivez les invites. Si une ou plusieurs machines ne peuvent pas être mises à niveau, un message explique pourquoi. Pour vous assurer que toutes les machines fonctionnent correctement, Citrix vous recommande de résoudre les problèmes de machine avant de cliquer sur Modifier pour continuer.

Une fois la modification du catalogue terminée, vous pouvez restaurer les machines à leurs versions VDA précédentes en sélectionnant le catalogue, puis en sélectionnant Annuler la modification du niveau fonctionnel dans la barre d’actions.

Cloner un catalogue

Avant de cloner un catalogue, tenez compte des considérations suivantes :

• Vous ne pouvez pas modifier les paramètres associés au système d’exploitation et à la gestion des machines. Le catalogue cloné hérite de ces paramètres de l’original.

Remarque :

Si vous sélectionnez un catalogue Azure à cloner et que vous sélectionnez une image maître, le panneau répertorie toutes les images qui appartiennent à la même région que celles des ressources.

• Le clonage d’un catalogue peut prendre un certain temps. Si nécessaire, sélectionnez Masquer la progression pour exécuter le clonage en arrière-plan.
• Le catalogue cloné hérite du nom de l’original et possède le suffixe Copy. Vous pouvez modifier le nom. Consultez Renommer un catalogue.
• Une fois le clonage terminé, assurez-vous d’affecter le catalogue cloné à un groupe de mise à disposition.

1. Connectez-vous à Web Studio, puis sélectionnez Catalogues de machines dans le volet gauche.
2. Sélectionnez un catalogue, puis sélectionnez Cloner dans la barre d’actions.
3. Dans la fenêtre Cloner le catalogue de machines sélectionné, affichez les paramètres du catalogue cloné et configurez les paramètres si nécessaire. Sélectionnez Suivant pour passer à la page suivante.
4. Sur la page Résumé, affichez un résumé des paramètres et sélectionnez Terminer pour démarrer le clonage.
5. Si nécessaire, sélectionnez Masquer la progression pour exécuter le clonage en arrière-plan.

Organiser les catalogues à l’aide de dossiers

Vous pouvez créer des dossiers pour organiser les catalogues afin d’y accéder facilement. Par exemple, vous pouvez organiser les catalogues par type d’image ou par structure organisationnelle.

Conseil :

Vous pouvez définir votre vue par défaut préférée (vue dossier ou vue liste) pour le nœud Catalogues de machines en cliquant sur l’icône Dossier en haut à droite de la barre d’actions.

Créer un dossier de catalogue

Avant de commencer, planifiez d’abord comment organiser vos catalogues. Tenez compte des points suivants :

• Vous pouvez imbriquer des dossiers jusqu’à cinq niveaux de profondeur (à l’exclusion du dossier racine par défaut).
• Un dossier de catalogue peut contenir des catalogues et des sous-dossiers.

• Tous les nœuds de Web Studio (tels que Catalogues de machines, Groupes de mise à disposition, Applications et Groupes d’applications) partagent la même arborescence de dossiers en arrière-plan. Pour éviter les conflits de noms lors du renommage ou du déplacement de dossiers, utilisez des noms uniques pour les dossiers de premier niveau sur les différents nœuds.

  Si vous créez un dossier à l’aide de la cmdlet SDK New-BrokerAdminFolder et que vous souhaitez qu’il apparaisse sous le nœud Catalogues de machines, vous devez ajouter les métadonnées ContainsMachineCatalogs à l’aide de la cmdlet Set-BrokerAdminFolderMetadata.

  Exemple :

   Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
   <!--NeedCopy-->
  

Pour créer un dossier de catalogue, suivez ces étapes :

1. Sélectionnez Catalogues de machines dans le volet gauche.
2. Dans la hiérarchie des dossiers, sélectionnez un dossier, puis sélectionnez Créer un dossier dans la barre Action.
3. Saisissez un nom pour le nouveau dossier, puis cliquez sur Terminé.

Conseil :

Si vous créez un dossier à un emplacement non intentionnel, vous pouvez le faire glisser vers l’emplacement correct.

Déplacer un catalogue

Vous pouvez déplacer un catalogue entre des dossiers. Les étapes détaillées sont les suivantes :

1. Sélectionnez Catalogues de machines dans le volet gauche.
2. Affichez les catalogues par dossier. Vous pouvez également activer Afficher tout au-dessus de la hiérarchie des dossiers pour afficher tous les catalogues en même temps.
3. Cliquez avec le bouton droit sur un catalogue, puis sélectionnez Déplacer le catalogue de machines.
4. Sélectionnez le dossier vers lequel vous souhaitez déplacer le catalogue, puis cliquez sur Terminé.

Conseil :

Vous pouvez faire glisser un catalogue vers un dossier.

Gérer les dossiers de catalogues

Vous pouvez supprimer, renommer et déplacer des dossiers de catalogues.

Vous ne pouvez supprimer un dossier que s’il ne contient pas de catalogues, ni lui ni ses sous-dossiers.

Pour gérer un dossier, suivez les étapes ci-dessous :

1. Sélectionnez Catalogues de machines dans le volet gauche.

2. Dans la hiérarchie des dossiers, sélectionnez un dossier, puis sélectionnez une action dans la barre Action selon vos besoins :

   • Pour renommer le dossier, sélectionnez Renommer le dossier.
   • Pour supprimer le dossier, sélectionnez Supprimer le dossier.
   • Pour déplacer le dossier, sélectionnez Déplacer le dossier.
3. Suivez les instructions à l’écran pour terminer les étapes restantes.

Mettre à niveau les VDA

Vous pouvez utiliser l’interface Studio pour mettre à niveau les VDA en toute simplicité. Pour plus d’informations et des instructions étape par étape, consultez la documentation du service de mise à niveau des VDA Citrix.

Relancer la création de catalogue

Remarque :

Cette fonctionnalité s’applique uniquement aux catalogues MCS.

Les catalogues ayant échoué sont marqués d’une icône d’erreur. Pour afficher les détails, accédez à l’onglet Dépannage de chaque catalogue. Avant de relancer la création de catalogue, tenez compte des considérations suivantes :

• Vérifiez d’abord les informations de dépannage et résolvez les problèmes. Les informations décrivent les problèmes détectés et fournissent des recommandations pour les résoudre.
• Vous ne pouvez pas modifier les paramètres associés au système d’exploitation et à la gestion des machines. Le catalogue hérite de ces paramètres de l’original.
• La création peut prendre un certain temps. Si nécessaire, sélectionnez Masquer la progression pour exécuter la création en arrière-plan.

Pour relancer la création d’un catalogue, procédez comme suit :

1. Depuis Web Studio, sélectionnez Catalogues de machines dans le volet gauche.
2. Sélectionnez le catalogue, puis accédez à son onglet Dépannage.
3. Cliquez sur le lien hypertexte de relance pour relancer la création du catalogue.
4. Dans l’assistant qui apparaît, modifiez les paramètres si nécessaire. S’il n’est pas nécessaire d’apporter des modifications, vous pouvez accéder directement à la page Résumé.
5. Une fois terminé, sélectionnez Terminer pour démarrer la création.

Enregistrer les VDA non provisionnés par MCS à l’aide de jetons

Vous pouvez désormais générer et gérer des jetons d’enregistrement pour les VDA non provisionnés par MCS. Cette implémentation permet l’enregistrement VDA via WebSocket sans provisionner les VDA avec MCS. Cette fonctionnalité prend également en charge Linux Virtual Delivery Agent, Citrix Virtual Delivery Agent pour macOS et les VDA non joints à un domaine avec Citrix Virtual Apps™ and Desktops.

Avant de commencer

1. Configurez votre site. Pour plus d’informations, consultez Créer un site.
2. Installez les certificats TLS sur les Delivery Controllers. Pour plus d’informations, consultez Installer les certificats de serveur TLS sur les contrôleurs.
3. Installez l’autorité de certification racine et l’autorité de certification intermédiaire sur le VDA pour faire confiance au Delivery Controller.

4. Activez la connexion WebSocket sur le Delivery Controller. Exécutez la commande suivante sur chaque Delivery Controller présent sur votre site :

   New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
   <!--NeedCopy-->
   

   Remarque :

   Assurez-vous de redémarrer les Delivery Controllers après avoir activé le WebSocket.

Générer des jetons d’enregistrement

Après avoir décidé d’activer l’enregistrement basé sur des jetons pour les machines non provisionnées par Citrix, vous devez d’abord générer des jetons par catalogue de machines, puis les partager avec les administrateurs d’installation VDA.

Un jeton d’enregistrement comprend :

• Plage d’enregistrement : 1 à 5000 machines VDA
• Période de validité : jusqu’à 14 jours

Pour générer un jeton pour un catalogue à l’aide de Web Studio, suivez les étapes suivantes :

1. Dans Web Studio > Catalogues de machines, recherchez un catalogue non provisionné par MCS, qui affiche Méthode de provisionnement : Manuelle dans la colonne Nombre de machines.
2. Cliquez avec le bouton droit sur le catalogue, puis sélectionnez Gérer les jetons d’inscription.
3. Sur la page Générer un jeton d’inscription qui s’affiche, fournissez les informations de jeton suivantes :
   • Saisissez un nom pour le jeton.
   • Saisissez sa période de validité. La période ne doit pas dépasser 14 jours. Le jeton n’est valide que pour la période spécifiée.
   • (Facultatif) Sélectionnez une connexion d’hôte pour la gestion de l’alimentation des VDA inscrits avec le jeton. Les options incluent toutes les connexions d’hôte sous la zone de ce catalogue.
   • Saisissez les limites d’utilisation du jeton (entre 1 et 5000).
4. Cliquez sur Générer.

5. Dans la fenêtre Jeton généré avec succès qui s’affiche, copiez le jeton et enregistrez-le dans un endroit sûr, ou cliquez sur Télécharger pour le télécharger dans le dossier Téléchargements.

   Un enregistrement de jeton apparaît dans la liste des jetons.

   

6. Partagez le jeton avec les administrateurs d’installation de VDA.

   Pour plus d’informations sur l’installation de VDA et d’un jeton sur des machines, consultez Installer des VDA.

Gérer les jetons

Vous avez deux options pour révoquer un jeton et le rendre indisponible pour l’inscription de VDA :

• Révoquer : révoque le jeton mais le conserve dans la liste à des fins de journalisation.
• Supprimer : révoque le jeton et le supprime de la liste.

Remarque :

Les jetons expirés sont automatiquement supprimés après 14 jours.

Inscrire des machines à des catalogues à l’aide de l’outil d’inscription VDA WebSocket

L’outil d’inscription VDA WebSocket facilite l’inscription basée sur des jetons pour les machines VDA. Cet outil vous aide à convertir une connexion en connexion WebSocket en ajoutant le VDA au catalogue de machines à l’aide du jeton d’inscription.

Remarque :

Cet outil est conçu pour inscrire des machines VDA qui n’ont été inscrites dans aucun catalogue de machines.

Suivez les instructions pour exécuter l’outil d’inscription :

1. Connectez-vous au VDA.
2. Localisez l’outil EnrollMachine.exe, dans C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
3. Exécutez l’outil avec les paramètres d’entrée appropriés. Par exemple : EnrollMachine.exe -websocket_token_string:xxxxxxxxx

Le tableau suivant décrit les paramètres d’entrée de l’outil d’inscription :

Après une inscription réussie, vous recevrez un message de succès sur l’outil et dans les journaux. Assurez-vous de vous connecter à Web Studio pour vérifier que la machine VDA est ajoutée au catalogue et que l’état de la machine est enregistré.

Dépannage

Par défaut, vous pouvez trouver les journaux de l’outil d’inscription à l’adresse :

C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

Si vous avez spécifié un chemin différent pour les journaux, vous pouvez utiliser log:[log-file-path] pour récupérer vos journaux.

Le tableau suivant répertorie les codes renvoyés par l’outil d’inscription :

Utiliser PowerShell

Cette section explique comment gérer les catalogues à l’aide de PowerShell :

• Récupérer les avertissements et les erreurs associés à un catalogue
• Ajouter des descriptions à une image
• Réinitialiser le disque du système d’exploitation
• Modifier le paramètre réseau d’un schéma de provisionnement existant
• Gérer les versions d’un catalogue de machines
• Convertir un catalogue de machines non basé sur un profil de machine en catalogue de machines basé sur un profil de machine
• Réparer les informations d’identité des comptes d’ordinateur actifs
• Modifier la configuration du cache sur un catalogue de machines existant
• Prise en charge de la mise à jour VDA via l’accès au partage de fichiers local

Récupérer les avertissements et les erreurs associés à un catalogue

Vous pouvez obtenir les erreurs et avertissements historiques pour comprendre les problèmes liés à votre catalogue de machines MCS et les résoudre.

À l’aide des commandes PowerShell, vous pouvez :

• Obtenir une liste d’erreurs ou d’avertissements
• Modifier l’état de l’avertissement de Nouveau à Accusé de réception
• Supprimer les erreurs ou les avertissements

Pour exécuter les commandes PowerShell :

1. Ouvrez une fenêtre PowerShell.
2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.

Pour obtenir une liste d’erreurs et d’avertissements :

Exécutez la commande Get-ProvOperationEvent.

• Sans paramètres : Obtient toutes les erreurs et tous les avertissements
• Avec les paramètres LinkedObjectType et LinkedObjectUid : Obtient toutes les erreurs et tous les avertissements associés à un schéma de provisioning spécifique
• Avec le paramètre EventId : Obtient une erreur ou un avertissement spécifique correspondant à cet ID d’événement
• Avec le paramètre Filter : Obtient les erreurs ou les avertissements par filtre personnalisé

Pour modifier l’état des erreurs ou des avertissements de Nouveau à Accusé de réception :

Exécutez la commande Confirm-ProvOperationEvent.

• Avec le paramètre EventId : Définit l’état d’une erreur ou d’un avertissement spécifique correspondant à cet ID d’événement. Vous pouvez obtenir l’EventId d’une erreur ou d’un avertissement spécifique en sortie de la commande Get-ProvOperationEvent
• Avec les paramètres LinkedObjectType et LinkedObjectUid : Définit l’état de toutes les erreurs et de tous les avertissements associés à un schéma de provisioning spécifique
• Avec le paramètre All : Définit l’état de toutes les erreurs et de tous les avertissements comme Accusé de réception

Pour supprimer les erreurs ou les avertissements :

Exécutez la commande Remove-ProvOperationEvent.

• Avec le paramètre EventId : Supprime une erreur ou un avertissement spécifique correspondant à cet ID d’événement. Vous pouvez obtenir l’EventId d’une erreur ou d’un avertissement spécifique en sortie de la commande Get-ProvOperationEvent
• Avec les paramètres LinkedObjectType et LinkedObjectUid : Supprime toutes les erreurs et tous les avertissements associés à un schéma de provisioning spécifique
• Avec le paramètre All : Supprime toutes les erreurs et tous les avertissements

Pour plus d’informations, consultez le SDK PowerShell de Citrix.

Supprimer des machines sans accès à l’hyperviseur

Lors de la suppression d’une VM ou d’un schéma de provisioning, MCS doit supprimer les balises de la VM, et parfois aussi du disque de base, afin que les ressources incluses dans les options de suppression ne soient plus suivies ou identifiées par MCS. Cependant, certaines de ces ressources ne sont accessibles que via l’hyperviseur. Utilisez l’option PurgeDBOnly dans la commande PowerShell Remove-ProvVM pour supprimer les objets de ressources de VM tels que la VM, le disque de base, l’image dans ACG, etc., de la base de données, même en l’absence d’accès à l’hyperviseur.

Cette option est activée sur :

• tous les hyperviseurs pris en charge
• les VM persistantes et non persistantes

Limitations

Vous ne pouvez pas utiliser les commandes -PurgeDBOnly et -ForgetVM en même temps.

Utiliser la commande PurgeDBOnly

Lors de l’exécution de la commande PowerShell Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM, l’opération de suppression peut échouer dans les scénarios suivants :

• La connexion hôte est en mode maintenance
• Informations d’identification non valides
• Échec de l’authentification
• Opération non autorisée
• L’hyperviseur est inaccessible

Remarque :

La commande Remove-ProvVM -ForgetVM ne cible que les VM persistantes. Si l’une des VM de la liste est non persistante, l’opération échoue.

Lorsque l’opération échoue parce que l’hyperviseur est inaccessible, l’invite suivante apparaît :

Try to use -PurgeDBOnly option to clean DDC database.

Utilisez l’option -PurgeDBOnly dans la commande PowerShell Remove-ProvVM pour supprimer les références d’une VM de la base de données MCS. Par exemple,

Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

Ajouter des descriptions à une image

Vous pouvez ajouter des descriptions informatives sur les modifications liées aux mises à jour d’images pour les catalogues de machines. Utilisez cette fonctionnalité pour ajouter une description lors de la création d’un catalogue ou lors de la mise à jour d’une image principale existante pour un catalogue. Vous pouvez également afficher des informations pour chaque image principale du catalogue. Utilisez les commandes suivantes pour ajouter ou afficher des descriptions d’images :

• Pour ajouter une note lors de la création d’un catalogue de machines avec une image principale, utilisez le paramètre MasterImageNote dans la commande NewProvScheme. Par exemple :

   C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
   XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
   <!--NeedCopy-->
  

• Pour mettre à jour l’image maître associée à un catalogue de machines, utilisez le paramètre MasterImageNote dans la commande Publish-ProvMasterVMImage. Par exemple :

   C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
   <!--NeedCopy-->
  

• Pour afficher les informations de chaque image, utilisez la commande Get-ProvSchemeMasterVMImageHistory. Par exemple :

   C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
   <!--NeedCopy-->
  

Pour suivre la progression du retour en arrière, localisez le catalogue dans Catalogues de machines afin d’afficher la barre de progression intégrée et le graphique de progression étape par étape.

Vous ne pouvez pas effectuer de retour en arrière dans certains scénarios, notamment les suivants. (L’option Restaurer l’image maître n’est pas visible).

• Vous n’avez pas l’autorisation d’effectuer un retour en arrière.
• Le catalogue n’a pas été créé à l’aide de MCS.
• Le catalogue a été créé à l’aide d’une image du disque du système d’exploitation.
• L’instantané utilisé pour créer le catalogue est corrompu.
• Les modifications apportées par l’utilisateur aux machines du catalogue ne sont pas persistantes.
• Les machines du catalogue sont en cours d’exécution.

Réinitialiser le disque du système d’exploitation

Utilisez la commande PowerShell Reset-ProvVMDisk pour réinitialiser le disque du système d’exploitation d’une VM persistante dans un catalogue de machines créé par MCS. Actuellement, cette fonctionnalité est applicable aux environnements de virtualisation AWS, Azure, XenServer, Google Cloud, SCVMM et VMware.

Pour exécuter la commande PowerShell avec succès, assurez-vous que :

• Les VM cibles se trouvent dans un catalogue MCS persistant.
• Le catalogue de machines MCS fonctionne correctement.
• Cela implique que le schéma de provisionnement et l’hôte existent, et que le schéma de provisionnement contient des entrées correctes.
• L’hyperviseur n’est pas en mode maintenance.
• Les VM cibles sont éteintes et en mode maintenance.

Effectuez les étapes suivantes pour réinitialiser le disque du système d’exploitation :

1. Ouvrez une fenêtre PowerShell.
2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.

3. Exécutez la commande PowerShell Reset-ProvVMDisk de l’une des manières suivantes :

   • Spécifiez la liste des VM sous forme de liste séparée par des virgules, et effectuez la réinitialisation sur chaque VM :

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
      <!--NeedCopy-->
     

   • Spécifiez la liste des VM comme sortie de la commande Get-ProvVM, et effectuez la réinitialisation sur chaque VM :

      (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
      <!--NeedCopy-->
     

   • Spécifiez une seule VM par son nom :

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
      <!--NeedCopy-->
     

   • Créez des tâches de réinitialisation distinctes pour chacune des VM renvoyées par la commande Get-ProvVM. Cette méthode est moins efficace car chaque tâche effectuera les mêmes vérifications redondantes, telles que la vérification des capacités de l’hyperviseur et la vérification de la connexion pour chaque VM.

      Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
      <!--NeedCopy-->
     

4. Une invite de confirmation apparaît, listant les VM à réinitialiser ainsi qu’un message d’avertissement indiquant qu’il s’agit d’une opération irrécupérable. Si vous ne fournissez pas de réponse et appuyez sur Entrée, aucune autre action n’est effectuée.

   Remarque :

   Ne retirez pas les VM du mode maintenance et ne les mettez pas sous tension avant la fin du processus de réinitialisation.

   Vous pouvez exécuter la commande PowerShell -WhatIf pour afficher l’action qu’elle effectuerait et quitter sans exécuter l’action.

   Vous pouvez également contourner l’invite de confirmation en utilisant l’une des méthodes suivantes :

   • Fournissez le paramètre -Force :

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
      <!--NeedCopy-->
     

   • Fournissez le paramètre -Confirm:$false :

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
      <!--NeedCopy-->
     

   • Avant d’exécuter Reset-ProvVMDisk, définissez $ConfirmPreference sur None :

      PS C:\Windows\system32> $ConfirmPreference='None'
      PS C:\Windows\system32> $ConfirmPreference
      None
      PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
      <!--NeedCopy-->
     

5. Exécutez Get-ProvTask pour obtenir l’état des tâches renvoyées par la commande Reset-ProvVMDisk.

Modifier le paramètre réseau d’un schéma de provisioning existant

Vous pouvez modifier le paramètre réseau d’un schéma de provisioning existant afin que les nouvelles machines virtuelles soient créées sur le nouveau sous-réseau. Utilisez le paramètre -NetworkMapping dans la commande Set-ProvScheme pour modifier le paramètre réseau.

Remarque :

Cette fonctionnalité est prise en charge sur Citrix Virtual Apps and Desktops 2203 LTSR CU3 et les versions ultérieures.

Pour modifier le paramètre réseau d’un schéma de provisioning existant, procédez comme suit :

1. Dans la fenêtre PowerShell, exécutez la commande asnp citrix* pour charger les modules PowerShell.
2. Exécutez (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps pour accéder au chemin réseau que vous souhaitez modifier.

3. Attribuez une variable au nouveau paramètre réseau. Par exemple :

   $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
   <!--NeedCopy-->
   

4. Exécutez Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
5. Exécutez (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps pour vérifier le nouveau paramètre réseau du schéma de provisioning existant.

Gérer les versions d’un catalogue de machines

Lorsqu’un catalogue de machines MCS est mis à jour avec la commande Set-ProvScheme, la configuration actuelle est enregistrée en tant que version. Vous pouvez ensuite gérer les différentes versions du catalogue de machines à l’aide de commandes PowerShell. Vous pouvez :

• Consulter la liste des versions d’un catalogue de machines
• Utiliser une version précédente pour mettre à jour le catalogue de machines
• Supprimer manuellement une version si elle n’est pas utilisée par une machine virtuelle de ce catalogue de machines
• Modifier le nombre maximal de versions à conserver par le catalogue de machines (la valeur par défaut est 99)

Une version inclut les informations suivantes d’un catalogue de machines :

• VMCpuCount
• VMMemoryMB
• CustomProperties
• ServiceOffering
• MachineProfile
• NetworkMapping
• SecurityGroup

Exécutez les commandes suivantes (fournies à titre d’exemples) pour gérer les différentes versions d’un catalogue de machines.

• Pour afficher les détails de configuration des différentes versions d’un catalogue de machines :

   Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
   <!--NeedCopy-->
  

• Pour afficher les détails de configuration d’une version particulière d’un catalogue de machines :

   Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
   <!--NeedCopy-->
  

• Pour afficher le nombre total de versions associées à un catalogue de machines :

   (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
   <!--NeedCopy-->
  

• Pour utiliser une version précédente afin de mettre à jour le catalogue de machines :

   Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
   <!--NeedCopy-->
  

• Pour supprimer manuellement une version si elle n’est pas utilisée par une machine virtuelle de ce catalogue de machines :

   Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
   <!--NeedCopy-->
  

• Pour définir le nombre maximal de versions à conserver par le catalogue de machines (la valeur par défaut est 99). Ce paramètre s’applique à tous les catalogues. Par exemple, dans ce cas, un maximum de 15 versions sera conservé pour tous les catalogues provisionnés par MCS.

   Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
   <!--NeedCopy-->
  

Si le nombre de versions atteint le nombre maximal de versions, une nouvelle version ne peut pas être créée si des versions plus anciennes sont utilisées par l’une des machines virtuelles du catalogue de machines. Dans ce cas, effectuez l’une des opérations suivantes :

• Augmentez la limite du nombre maximal de versions à conserver par le catalogue de machines.
• Mettez à jour certaines machines virtuelles qui utilisent des versions plus anciennes afin que ces versions plus anciennes ne soient plus référencées par aucune machine virtuelle et puissent être supprimées.

Convertir un catalogue de machines non basé sur un profil de machine en catalogue de machines basé sur un profil de machine

Vous pouvez utiliser une machine virtuelle (VM), une spécification de modèle (dans le cas d’Azure), un modèle de lancement (dans le cas d’AWS) ou un modèle VMware (dans le cas de VMware) comme entrée de profil de machine pour convertir un catalogue de machines non basé sur un profil de machine en un catalogue de machines basé sur un profil de machine. Les nouvelles machines virtuelles ajoutées au catalogue héritent des valeurs de propriété du profil de machine, sauf si elles sont remplacées par une propriété personnalisée explicite.

Remarque :

Un catalogue de machines existant basé sur un profil de machine ne peut pas être converti en un catalogue de machines non basé sur un profil de machine.

Pour ce faire :

1. Créez un catalogue de machines persistant ou non persistant avec des machines virtuelles et sans profil de machine.
2. Ouvrez la fenêtre PowerShell.

3. Exécutez la commande Set-ProvScheme pour appliquer les valeurs de propriété du profil de machine aux nouvelles machines virtuelles ajoutées au catalogue de machines. Par exemple :

   • Dans le cas d’Azure :

      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
      <!--NeedCopy-->
     

   • Dans le cas d’AWS :

      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
      <!--NeedCopy-->
     

   • Dans le cas de VMware :

       Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
      <!--NeedCopy-->
     

     Remarque :

     Définissez le FolderID comme propriété personnalisée pour éviter de dériver le FolderID du modèle VMware.

Réparer les informations d’identité des comptes d’ordinateur actifs

Vous pouvez réinitialiser les informations d’identité des comptes d’ordinateur actifs qui présentent des problèmes liés à l’identité. Vous pouvez choisir de réinitialiser uniquement le mot de passe de la machine et les clés de confiance, ou de réinitialiser toute la configuration du disque d’identité. Cette implémentation est applicable aux catalogues de machines MCS persistants et non persistants.

Remarque :

Actuellement, cette fonctionnalité est prise en charge pour les environnements de virtualisation AWS, GCP, Azure, SCVMM, XenServer et VMware.

Conditions

Assurez-vous des points suivants pour réinitialiser le disque d’identité avec succès :

• Éteignez la machine virtuelle et mettez-la en mode maintenance.
• N’incluez pas le paramètre -OS dans la commande PowerShell.

Réinitialiser le disque d’identité

Pour réinitialiser le disque d’identité :

1. Ouvrez la fenêtre PowerShell.
2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.

3. Réinitialisez les informations d’identité.

   • Pour réinitialiser uniquement le mot de passe de la machine et les clés de confiance, exécutez la commande suivante :

      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
      <!--NeedCopy-->
     

     La description des paramètres utilisés dans la commande est la suivante :

     • IdentityAccountName : Nom du compte d’identité à réparer.
     • PrivilegedUserName : Compte utilisateur disposant des autorisations d’écriture sur le fournisseur d’identité (AD ou AzureAD).
     • PrivilegedUserPassword : Mot de passe de PrivilegedUserName.
     • Target : Cible de l’action de réparation. Il peut s’agir de IdentityInfo pour réparer le mot de passe du compte/la clé de confiance, et de UserCertificate pour réparer les attributs de certificat utilisateur des identités de machine jointes à Microsoft Entra hybride.

   • Pour réinitialiser toute la configuration du disque d’identité, exécutez les commandes suivantes dans l’ordre indiqué :

      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
      <!--NeedCopy-->
     

      Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
      <!--NeedCopy-->
     

   • Pour recréer complètement le disque d’identité :

      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
      <!--NeedCopy-->
     

     Remarque :

     Si la machine est une machine Windows utilisant la version 2511 ou ultérieure du VDA, elle continuera à utiliser le même MachineGuid qu’auparavant, quel que soit le paramètre -Recreate.

4. Tapez y pour confirmer l’action. Vous pouvez également ignorer l’invite de confirmation en utilisant le paramètre -Force. Par exemple :

   Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
   <!--NeedCopy-->
   

5. Exécutez Get-ProvVM -ProvisioningSchemeName <name -VMName <name> pour vérifier le paramètre mis à jour du disque d’identité. Les attributs du disque d’identité (par exemple, IdentityDiskId) doivent être mis à jour. Les valeurs StorageId et IdentityDiskIndex ne doivent pas changer.

Modifier la configuration du cache sur un catalogue de machines existant

Après avoir créé un catalogue non persistant avec MCSIO activé, vous pouvez utiliser la commande Set-ProvScheme pour modifier les paramètres suivants :

• WriteBackCacheMemorySize
• WriteBackCacheDiskSize

Cette fonctionnalité s’applique actuellement à :

• environnements GCP et Microsoft Azure, et
• un catalogue non persistant avec MCSIO activé

Exigences

Les exigences pour modifier la configuration du cache sont les suivantes :

• Mise à jour vers la dernière version du VDA (2308 ou ultérieure).

• Activez le paramètre UseWriteBackCache pour le catalogue de machines existant. Utilisez New-ProvScheme pour créer un catalogue de machines avec UseWriteBackCache activé. Par exemple :

   New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
   -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
   -MasterImageVM $MasterImage `
   -ServiceOffering $ServiceOffering `
   -NetworkMap $NetworkMap `
   -SecurityGroup $SecurityGroup `
   -UseWriteBackCache -WriteBackCacheDiskSize 8
   <!--NeedCopy-->
  

Modifier la configuration du cache

Exécutez la commande Set-ProvScheme. Par exemple :

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

Remarque :

• La valeur de WriteBackCacheDiskSize doit être supérieure à zéro, car au moins 1 Go de stockage sur disque cache est requis.
• La valeur de WriteBackCacheMemorySize doit être inférieure à la taille de la mémoire du catalogue de machines.
• Ces modifications n’affectent que les nouvelles machines virtuelles ajoutées au catalogue après la modification. Les machines virtuelles existantes ne sont pas affectées par ces modifications.

Prise en charge de la mise à jour du VDA via l’accès au partage de fichiers local

Spécifiez l’emplacement du programme d’installation du VDA via des cmdlets PowerShell, ce qui réduit vos efforts en matière de fourniture de règles réseau pour permettre à chaque VDA d’aller récupérer le nouveau programme d’installation du VDA à partir du CDN Azure géré par Citrix.

Cmdlets PowerShell

Deux nouveaux paramètres facultatifs ont été ajoutés aux cmdlets New-VusCatalogSchedule et New-VusMachineUpgrade qui vous permettent d’utiliser des programmes d’installation à partir d’un partage de fichiers local

• VdaWorkstationPackageUri - pour spécifier le chemin UNC vers le programme d’installation du VDA du système d’exploitation de la station de travail
• VdaServerPackageUri - pour spécifier le chemin UNC vers le programme d’installation du VDA du système d’exploitation du serveur

Prérequis

• Programme d’installation de l’agent VUS fourni avec VDA 2311
• Agent de mise à niveau VDA vers la version 7.40.0.35 ou ultérieure (utilisant la version 2311 ou ultérieure du programme d’installation du VDA)
• SDK PowerShell distant Virtual Apps and Desktops version 7.40 ou plus récente (publié le 10 janvier 2024 ou ultérieurement)

Comment définir les autorisations de partage de fichiers

Les partages réseau contenant les packages d’installation du VDA doivent disposer d’un accès en lecture pour le service VDA Upgrade Agent qui s’exécute en tant que système local (principal NT AUTHORITY\SYSTEM).

• Autorisation de partage de fichiers joint au domaine

  Lorsque la machine VDA est jointe à un domaine, le compte Système local (VUA s’exécute en tant que Système local) utilise les informations d’identification de l’ordinateur lors de l’accès aux partages réseau.

  L’autorisation de moindre privilège peut être définie en accordant l’accès en lecture aux ordinateurs du domaine.

  1. Choisissez les personnes de votre réseau avec lesquelles vous souhaitez partager le fichier.
  2. Cliquez sur Paramètres de partage avancés et activez le Partage de fichiers et d’imprimantes.

• Autorisation de partage de fichiers non joint au domaine

  Lorsque la machine VDA n’est pas jointe à un domaine, le compte Système local (VUA s’exécute en tant que Système local) utilise l’OUVERTURE DE SESSION ANONYME lors de l’accès aux partages réseau.

1. Sélectionnez un dossier partagé.
2. Désactivez la protection par mot de passe.
   1. Accédez aux Propriétés du dossier.
   2. Sélectionnez le Centre Réseau et partage.
   3. Désactivez le Partage protégé par mot de passe.
3. Cliquez sur Partage avancé pour accorder une autorisation de partage.
   1. Sélectionnez Autorisations.
   2. Accordez une autorisation de partage en Lecture à OUVERTURE DE SESSION ANONYME.
4. Sélectionnez l’onglet Sécurité pour accorder des autorisations de dossier.
   1. Cliquez sur Modifier pour ajouter des autorisations au dossier partagé.
   2. Sélectionnez le dossier partagé pour accorder des autorisations de dossier à OUVERTURE DE SESSION ANONYME.
5. Cliquez sur Avancé pour activer le Partage de fichiers et d’imprimantes.
6. Ajoutez le nom du dossier partagé à la Stratégie de sécurité d’accès réseau.

Remarque :

Redémarrez votre machine pour que la modification prenne effet immédiatement.

Mises à jour VDA à partir d’un partage de fichiers local

1. Téléchargez le programme d’installation du VDA et placez-le dans le fichier partagé.

   Remarque :

   Avec le service de mise à niveau virtuelle, vous pouvez choisir entre la piste Current Release ou la piste LTSR.

   Par exemple : Si le catalogue de machines est défini sur Current Release (2311) et que la version du VDA est 2305, vous devez mettre à niveau le VDA vers la version 2311.

   1. Accédez à la page Téléchargements sur notre site web.
   2. Sélectionnez Citrix Virtual Apps and Desktops comme produit.
   3. Sélectionnez Citrix Virtual Apps and Desktops 7 2311, Toutes éditions.
   4. Sélectionnez le programme d’installation du VDA dans la section extensible Composants figurant sur l’ISO du produit mais également empaquetés séparément.

2. Sélectionnez le programme d’installation du VDA approprié en fonction du type de catalogue.

   • Téléchargez le programme d’installation du VDA pour OS multi-session si le type de catalogue est multi-session.
   • Téléchargez le programme d’installation du VDA pour OS mono-session si le type de catalogue est mono-session.
   • Téléchargez le programme d’installation du VDA pour OS mono-session (Services principaux) si le type de catalogue est Accès PC distant.

Remarque :

La version du programme d’installation du partage de fichiers doit correspondre exactement à la version du dernier programme d’installation publié par VUS dans le cloud.

Migration du stockage des machines virtuelles

Vous pouvez déplacer le stockage sur disque des machines virtuelles existantes d’un ancien stockage vers un nouveau stockage dans les environnements VMware et XenServer. Pendant la migration, MCS conserve les capacités des machines virtuelles telles que la gestion de l’alimentation, la réinitialisation du disque du système d’exploitation, etc. Vous pouvez également ajouter de nouvelles machines virtuelles au catalogue de machines à l’aide du nouveau stockage sur disque. Pour ce faire, utilisez la commande PowerShell Move-ProvVMDisk.

Vous pouvez migrer des machines virtuelles persistantes à clone complet et des machines virtuelles non persistantes.

• Pour les machines virtuelles persistantes à clone complet : Disque du système d’exploitation, Disque d’identité et disques provisionnés non-MCS.
• Pour les machines virtuelles non persistantes : Disque du système d’exploitation, Disque d’identité et disque de cache en écriture (WBC).

Le nouveau stockage doit satisfaire aux conditions suivantes :

• Il doit se trouver dans le même cluster que l’ancien stockage.
• L’hôte sur lequel la machine virtuelle s’exécute doit avoir accès aux anciens et aux nouveaux datastores.

Migrer le stockage sur disque

Pour migrer le stockage sur disque :

1. Ajoutez un stockage de destination à une unité d’hébergement existante. Vous pouvez exécuter la commande PowerShell Add-Hyphostingunitstorage pour ajouter le stockage de destination :

   Si vous ne souhaitez pas ajouter de nouvelles machines virtuelles à l’ancien stockage, remplacez l’ancien stockage par Obsolète. Vous pouvez le faire à l’aide de Studio ou de commandes PowerShell. Pour Studio, consultez Modifier le stockage. Vous pouvez également exécuter Set-Hyphostingunitstorage et définir Superseded sur true pour désactiver la création de nouvelles machines virtuelles dans l’ancien stockage.

   Remarque :

   Pour les machines virtuelles non persistantes :

   • Si le WBC est utilisé, configurez le stockage de destination du WBC dans l’unité d’hébergement.
   • Si le stockage de destination du système d’exploitation est configuré, le WBC (s’il est utilisé) doit être compatible avec le stockage de destination du système d’exploitation.
   • Si le stockage de destination du système d’exploitation n’est pas configuré, le WBC (s’il est utilisé) doit être compatible avec le stockage actuel du système d’exploitation.

2. Éteignez les machines virtuelles et activez le Mode maintenance.

3. Obtenez les informations sur le schéma de provisionnement, l’unité d’hébergement, le stockage sur disque du système d’exploitation et le stockage sur disque WBC.

   • Exécutez ProvResourceInStorage pour obtenir les informations de stockage du système d’exploitation. Par exemple :

      $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
      $result
      $result.ProvResourceInStorage | Format-List -Property *
      <!--NeedCopy-->
     

   • Exécutez TemporaryStorageInfo pour obtenir les informations de stockage du WBC. Par exemple :

      $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
      $result
      $result.TemporaryStorageInfo | Format-List -Property *
      <!--NeedCopy-->
     

4. Migrez le disque du système d’exploitation, le disque d’identité et le disque WBC (applicable aux machines virtuelles non persistantes) vers le stockage de destination à l’aide de la commande PowerShell Move-ProvVMDisk.

   Remarque :

   • Fournissez toujours les disques du système d’exploitation et d’identité dans les paramètres DiskType et DestinationStorageId.
   • Le DestinationStorageId pour le disque du système d’exploitation et le disque d’identité doit être identique.

Exemple :

Machines virtuelles persistantes :

```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy--> ```

> **Important :**
>
> Pour les machines virtuelles persistantes, tous les disques sont déplacés. Vous ne pouvez pas sélectionner les disques à déplacer.

Machines virtuelles non persistantes :

```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
<!--NeedCopy--> ```

> **Important :**
>
> -  Si vous ne souhaitez pas migrer un disque spécifique, définissez la valeur sur `None` pour le paramètre `DestinationStorageId`.
> -  Si la machine virtuelle possède un disque WBC, ajoutez le disque WBC dans le paramètre `DiskType` et les informations requises dans le paramètre `DestinationStorageId`.

Migrer des catalogues de machines provisionnés par MCS existants vers un catalogue de machines d’images préparées

Vous pouvez convertir un catalogue de machines provisionné par MCS existant en un catalogue de machines d’images préparées à l’aide d’une commande PowerShell Set-ProvSchemeImage. Cependant, vous ne pouvez pas revenir au catalogue hérité après la migration. Actuellement, cette fonctionnalité est applicable aux environnements de virtualisation Azure et VMware.

Limitations

Tenez compte des limitations suivantes :

• Si le catalogue MCS utilise un disque de données persistant, le catalogue ne peut pas être migré pour utiliser une image préparée.
• Si le catalogue MCS utilise des disques non gérés, le catalogue ne peut pas être migré pour utiliser une image préparée.

Migrer vers un catalogue de machines d’images préparées

Pour migrer, procédez comme suit :

1. Créez une définition d’image et des versions d’image à l’aide de Studio ou de commandes PowerShell. Consultez les étapes de création de définitions d’image et de versions d’image dans :

   • Azure :

     • Web Studio
     • PowerShell

   • VMware :

     • Web Studio
     • PowerShell

2. Exécutez la commande Get-ProvScheme pour obtenir l’UID du schéma de provisioning. Par exemple :

   Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
   <!--NeedCopy-->
   

3. Exécutez la commande Get-ProvImageVersionSpec pour obtenir le nom de la définition d’image et l’UID de la spécification de version d’image. Par exemple :

   Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
   <!--NeedCopy-->
   

4. Exécutez la commande Set-ProvSchemeImage pour migrer un catalogue de machines provisionné par MCS existant vers un catalogue de machines d’images préparées. Par exemple :

   Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
   <!--NeedCopy-->
   

5. Exécutez la commande Get-ProvScheme pour vérifier que le catalogue est migré. Par exemple :

   Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid
   <!--NeedCopy-->
   

Dépannage

• Pour les machines dont l’état d’alimentation est « Inconnu », consultez CTX131267 pour obtenir des conseils.
• Pour résoudre le problème des machines virtuelles qui affichent continuellement un état d’alimentation inconnu, consultez Comment réparer les machines virtuelles qui affichent continuellement un état d’alimentation inconnu.

Où aller ensuite

Pour plus d’informations sur la gestion des catalogues de services cloud spécifiques, consultez :

• Gérer un catalogue AWS
• Gérer un catalogue XenServer
• Gérer un catalogue Google Cloud Platform
• Gérer un catalogue Microsoft Azure
• Gérer un catalogue Microsoft System Center Virtual Machine Manager
• Gérer un catalogue VMware