Citrix Virtual Apps and Desktops

Gérer les catalogues de machines

March 25, 2024

Contributeur:

Remarque :

Vous pouvez gérer votre déploiement de Citrix Virtual Apps and Desktops à l’aide de deux consoles de gestion : Web Studio (console basée sur le Web) et Citrix Studio (console basée sur Windows). Cet article ne concerne que Web Studio. Pour plus d’informations sur Citrix Studio, consultez l’article équivalent dans Citrix Virtual Apps and Desktops 7 2212 ou version antérieure.

Introduction

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

Il peut également être nécessaire de s’assurer que chaque machine dispose des dernières mises à jour du système d’exploitation, y compris les mises à jour antivirus, les mises à niveau du système d’exploitation ou les modifications de configuration.

Les catalogues contenant des machines regroupées au hasard créées à l’aide de Machine Creation Services (MCS) gèrent 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 de manière efficace un grand nombre de machines utilisateur.
Pour les catalogues contenant des machines Remote PC Access et statiques, gérez les mises à jour des machines des utilisateurs en dehors de Web Studio. Effectuez cette tâche individuellement ou collectivement en utilisant des outils de distribution de logiciels tiers.

Pour de plus amples informations sur la création et la gestion de connexions à des hyperviseurs hôtes, consultez l’article Connexions et ressources.

Remarque :

MCS ne prend pas en charge Windows 10 IoT Standard et Windows 10 IoT Entreprise. Consultez le site Microsoft pour obtenir des informations supplémentaires.

À 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 se fait de la même manière pour tout autre type de catalogue. Tenez compte des considérations suivantes :

Pour 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 lors de la prochaine réinitialisation de la machine.
Pour les catalogues de machines persistantes, la mise à jour de l’image met également à jour les instances du catalogue qui l’utilisent.
Pour les catalogues non 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 explique comment gérer les catalogues à l’aide de Web Studio :

Ajouter des machines à un catalogue

Avant de commencer :

Assurez-vous que l’ordinateur hôte de virtualisation dispose de suffisamment de processeurs, de mémoire et de stockage pour prendre en charge les machines supplémentaires.
Vérifiez que vous disposez de suffisamment de comptes d’ordinateurs 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’ordinateurs Active Directory pour les machines supplémentaires, vous devez disposer des droits d’administrateur de domaine.

Pour ajouter des machines à un catalogue :

Connectez-vous à Web Studio.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionnez un catalogue de machines, puis sélectionnez Ajouter des machines dans la barre d’actions.
Sélectionnez le nombre de machines virtuelles à ajouter.
S’il n’y a pas suffisamment de comptes Active Directory 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 d’attribution de nom du compte, à l’aide des marques de hachage pour indiquer l’emplacement où les numéros séquentiels ou les lettres apparaissent. N’utilisez pas de barre oblique (/) dans un nom d’unité d’organisation. Un nom ne peut pas commencer par un chiffre. Par exemple, un principe de dénomination de PC-Sales-## (avec 0-9 sélectionné) dans les comptes d’ordinateur nommés PC-Sales-01, PC-Sales-02, PC-Sales-03, etc.
Si vous utilisez des comptes Active Directory existants, vous pouvez sélectionner les comptes ou cliquer sur Importer et spécifier un fichier .csv contenant les noms de compte. Assurez-vous qu’il existe 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 de compte (qui doit être le même pour tous les comptes).

Les machines sont créées en tant que processus en arrière-plan, qui peut être long lors de la création de plusieurs machines. La création de la machine se poursuit même si vous fermez Web Studio.

Supprimer des machines d’un catalogue

Lorsque vous supprimez une machine d’un catalogue de machines, les utilisateurs ne peuvent plus y accéder ; donc, avant de supprimer une machine, assurez-vous que :

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

Pour supprimer des machines d’un catalogue :

Connectez-vous à Web Studio.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionner un catalogue, puis sélectionnez Afficher les machines dans la barre d’actions.
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 pour ces machines doivent être conservés, désactivés ou supprimés.

Modifier un catalogue

Sur la page Description, modifiez la description du catalogue.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionnez un catalogue, puis sélectionnez Modifier le catalogue de machines dans la barre d’actions.
Sur la page Étendues, modifiez les étendues.
Des pages supplémentaires peuvent s’afficher en fonction du type de catalogue.

Pour les catalogues créés à l’aide d’une image Azure Resource Manager, les pages suivantes sont visibles. N’oubliez pas que les modifications que vous apportez ne s’appliquent qu’aux machines que vous ajouterez ultérieurement au catalogue. Les machines existantes restent inchangées.
- Sur la page Machines virtuelles, modifiez la taille de la machine et les zones de disponibilité dans lesquelles 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.
- Sur la page Profil de la machine, choisissez d’utiliser ou de modifier un profil de machine.
- (Uniquement visible lorsque le catalogue est configuré avec un hôte de groupe dédié) Sur la page Groupe d’hôtes dédié, choisissez si vous souhaitez modifier un groupe d’hôtes.
- Sur la page Types de stockage et de licence, choisissez de modifier le type de stockage, le type de licence et les paramètres Azure Computer Gallery (disponibles uniquement lorsque l’option Placer une image préparée dans Azure Gallery est utilisé).
Remarque :

Si le nouveau paramètre sélectionné ne prend pas en charge la taille actuelle de la machine, une boîte de dialogue d’avertissement apparaît, vous informant que la modification du paramètre réinitialisera le paramètre de taille de la 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 Types de licence, indiquez si vous souhaitez modifier le paramètre de licence Windows ou Linux.
Pour les catalogues Remote PC Access, 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.
Cliquez sur Appliquer pour appliquer les modifications que vous avez apportées et cliquez sur Enregistrer pour quitter la page.

Renommer un catalogue

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

Déplacer un catalogue vers une autre zone

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

Le déplacement d’un catalogue vers une zone autre que l’hyperviseur contenant les machine virtuelle de ce catalogue affecte les performances.

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

Supprimer un catalogue

Avant de supprimer un catalogue, vérifiez ce qui suit :

Tous les utilisateurs ont fermé leur session et qu’aucune session déconnectée n’est en cours d’exécution.
Le mode de maintenance est activé pour toutes les machines du catalogue, de sorte qu’il ne soit pas possible d’effectuer de nouvelles connexions.
Toutes les machines des catalogues 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 les machines du catalogue.

Pour supprimer un catalogue :

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

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

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

Libérer des comptes de machines non utilisés en supprimant les comptes d’ordinateurs Active Directory des catalogues de machines avec OS mono-session et avec OS multi-session. Ces comptes peuvent ensuite être utilisés pour d’autres machines.
Ajoutez des comptes de façon à ce que lorsque plus de machines sont ajoutées au catalogue, les comptes d’ordinateurs 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 :

Connectez-vous à Web Studio.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionnez un catalogue, puis sélectionnez Gérer les comptes AD dans la barre d’actions.
Choisissez si vous souhaitez ajouter ou supprimer des comptes d’ordinateurs. Si vous ajoutez des comptes, indiquez la marche à suivre avec les mots de passe de compte : les réinitialiser ou entrer 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 de compte actuels, vous devez avoir l’autorisation d’effectuer une réinitialisation du mot de passe. Lorsque vous entrez un mot de passe, le mot de passe est modifié sur les comptes lors de leur importation. Lorsque vous supprimez un compte, indiquez si le compte dans Active Directory doit être conservé, désactivé ou supprimé.

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

Mettre un catalogue à jour

Nous vous recommandons de sauvegarder des copies ou des instantanés des images principales avant de mettre à jour les machines dans le catalogue. La base de données conserve un enregistrement historique des images principales utilisées avec chaque catalogue de machines. Restaurez 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 déployées sur leurs bureaux. Cela réduit les temps d’inactivité des utilisateurs. Ne supprimez, déplacez ou renommez pas les images principales. Vous ne pouvez pas rétablir leur utilisation pour un catalogue.

Après qu’une machine a été mise à jour, elle 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 une image sur votre hyperviseur hôte.

Sur votre hyperviseur, prenez un instantané de la machine virtuelle et donnez à l’instantané un nom significatif. Cet instantané peut être utilisé pour rétablir (restaurer) des machines dans le catalogue, si nécessaire.
Si nécessaire, démarrez l’image principale et ouvrez une session.
Installez les mises à jour ou apportez les modifications requises à l’image principale.
Arrêtez la machine virtuelle.
Prenez un instantané de la machine virtuelle. Donnez-lui un nom significatif qui sera reconnu lorsque le catalogue sera mis à jour 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. Cette méthode vous permet de choisir 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 XenCenter de XenServer.

Modifier l’image principale

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

Connectez-vous à Web Studio.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionnez un catalogue, puis sélectionnez Modifier image principale dans la barre d’actions.
Sur la page Image principale, sélectionnez l’hôte et l’image que vous voulez 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 ou non une note. Si vous mettez à jour un catalogue sans ajouter de note, l’entrée apparaît sous la forme null (-). 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 sur Afficher l’historique des notes.
Sur la page Stratégie de déploiement, indiquez lorsque les machines du catalogue de machines doivent être mises à jour avec la nouvelle image principale : lors de la prochaine fermeture de session 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.
Sur la page Résumé, vérifiez les informations et 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 intégrée et le graphique de progression étape par étape.

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

Stratégie de déploiement :

La mise à jour de l’image lors de l’arrêt suivant affectera immédiatement toutes les machines qui ne sont pas en cours d’utilisation, c’est-à-dire les machines sur lesquelles aucune session utilisateur n’est active. Un système utilisé reçoit la mise à jour à la fin de la session active en cours. Tenez compte des considérations suivantes :

Il n’est pas possible de lancer de nouvelles sessions tant que la mise à jour n’est pas terminée sur les machines applicables.
Les machines avec OS mono session sont immédiatement mises à jour lorsque la machine n’est pas utilisée ou lorsque des utilisateurs ne sont pas connectés.
Pour un OS multi-session avec des machines enfants, les redémarrages ne se produisent pas automatiquement. Ils doivent être arrêtés manuellement et redémarrés.

Conseil :

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

Si vous souhaitez activer le programme de redémarrage unique à l’aide de PowerShell, consultez la section Activer le programme de redémarrage unique.

Restaurer l’image principale

Après avoir déployé une image principale mise à jour ou nouvelle, vous pouvez la restaurer. Cette opération peut être nécessaire si des problèmes se produisent avec les machines mises à jour. Lors de la restauration, les machines du catalogue reviennent à la dernière image fonctionnelle. Les nouvelles fonctionnalités qui nécessitent la nouvelle image ne sont plus disponibles. Comme avec le déploiement, restaurer une machine implique un redémarrage.

Connectez-vous à Web Studio.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionnez le catalogue, puis sélectionnez Restaurer image principale dans la barre d’actions.
Spécifiez quand appliquer la version antérieure de l’image principale aux machines, comme dans la section précédente pour l’opération de déploiement.

La restauration n’est appliquée qu’aux machines qui doivent être rétablies. Les machines qui n’ont pas été mises à jour avec l’image principale nouvelle ou mise à jour ne reçoivent pas de messages de notification et ne sont pas forcées de fermer la session.

Pour suivre la progression de la restauration, 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 des machines vers une version plus récente. Citrix recommande de mettre à niveau tous les VDA vers la version la plus récente de façon à ce qu’ils puissent tous accéder à toutes les fonctionnalités les plus récentes.

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. Cela permet à Web Studio de déterminer si les machines du catalogue doivent être mises à niveau.

Pour modifier le niveau fonctionnel d’un catalogue :

Connectez-vous à Web Studio.
Sélectionnez Catalogues de machines dans le volet de gauche.
Sélectionnez le catalogue. L’onglet Détails dans le volet inférieur affiche les informations de version.
Sélectionnez Modifier le niveau fonctionnel. Si Web Studio détecte que le catalogue a besoin de procéder à la mise à niveau, il affiche un message. Suivez les invites. Si une ou plusieurs machines ne peut pas être mise à niveau, un message explique pourquoi. Pour garantir le bon fonctionnement de toutes les machines, Citrix vous recommande de résoudre ces problèmes avant de cliquer sur Modifier.

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

Cloner un catalogue

Avant de cloner un catalogue, prenez en compte les informations suivantes :

Vous ne pouvez pas modifier les paramètres associés à la gestion des systèmes d’exploitation et des machines. Le catalogue cloné hérite de ces paramètres de l’original.
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 comporte un suffixe Copy. Vous pouvez modifier le nom. Consultez la section Renommer un catalogue.
Une fois le clonage terminé, veillez à attribuer le catalogue cloné à un groupe de mise à disposition.

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

Organiser les catalogues sous forme de dossiers

Vous pouvez créer des dossiers pour organiser les catalogues afin d’en faciliter l’accès. Par exemple, vous pouvez organiser les catalogues par type d’image ou par structure organisationnelle.

Créer un dossier de catalogues

Avant de commencer, planifiez d’abord comment organiser vos catalogues. Tenez compte des considérations suivantes :

Vous pouvez imbriquer des dossiers sur un maximum de cinq niveaux de profondeur (à l’exception du dossier racine par défaut).
Un dossier de catalogues peut contenir des catalogues et des sous-dossiers.
Tous les nœuds dans Web Studio (tels que les nœuds Catalogues de machines et Applications) partagent une arborescence de dossiers dans le back-end. Pour éviter les conflits de nom avec d’autres nœuds lorsque vous renommez ou déplacez des dossiers, nous vous recommandons de donner des noms différents aux dossiers de premier niveau dans différents nœuds.

Pour créer un dossier de catalogues, procédez comme suit :

Sélectionnez Catalogues de machines dans le volet de gauche.
Dans la hiérarchie des dossiers, sélectionnez un dossier, puis sélectionnez Créer un dossier dans la barre d’actions.
Entrez un nom pour le nouveau dossier, puis cliquez sur Terminé.

Conseil :

Si vous créez un dossier dans le mauvais emplacement, vous pouvez le faire glisser vers l’emplacement approprié.

Déplacer un catalogue

Vous pouvez déplacer un catalogue d’un dossier à l’autre. Les étapes détaillées sont les suivantes :

Sélectionnez Catalogues de machines dans le volet de gauche.
Afficher les catalogues par dossier. Vous pouvez également activer Afficher tout au-dessus de la hiérarchie des dossiers pour afficher tous les catalogues à la fois.
Cliquez avec le bouton droit sur un catalogue puis sélectionnez Déplacer catalogue de machines
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 si celui-ci et ses sous-dossiers ne contiennent pas de catalogues.

Pour gérer un dossier, procédez comme suit :

Sélectionnez Catalogues de machines dans le volet de gauche.
Dans la hiérarchie des dossiers, sélectionnez un dossier, puis sélectionnez une action dans la barre d’actions 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.
Suivez les instructions à l’écran pour effectuer les étapes restantes.

Utiliser PowerShell

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

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

Vous pouvez consulter l’historique des erreurs et des avertissements 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
Changer l’état d’avertissement de New à Acknowledged
Supprimer les erreurs ou les avertissements

Pour exécuter les commandes PowerShell :

Ouvrez une fenêtre PowerShell.
Exécutez asnp citrix* pour charger des modules PowerShell propres à Citrix.

Pour obtenir la liste des erreurs et des avertissements :

Exécutez la commande Get-ProvOperationEvent.

Aucun paramètre : affiche toutes les erreurs et tous les avertissements.
Paramètre LinkedObjectType et LinkedObjectUid : affiche toutes les erreurs et tous les avertissements associés à un schéma de provisioning spécifique.
Paramètre EventId : affiche une erreur ou un avertissement spécifique correspondant à cet ID d’événement.
Paramètre Filter : affiche des erreurs ou des avertissements par filtre personnalisé.

Pour changer l’état des erreurs ou des avertissements de New à Acknowledged :

Exécutez la commande Confirm-ProvOperationEvent.

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’élément EventId d’une erreur ou d’un avertissement spécifique en tant que sortie de la commande Get-ProvOperationEvent.
Paramètre 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.
Paramètre All : définit l’état de toutes les erreurs et de tous les avertissements sur Acknowledged.

Pour supprimer les erreurs ou les avertissements :

Exécutez la commande Remove-ProvOperationEvent.

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

Pour plus d’informations, accédez à cette page sur le SDK Citrix PowerShell.

Activer le calendrier de redémarrage unique

Si vous souhaitez activer le programme de redémarrage unique à l’aide de PowerShell, utilisez les commandes PowerShell BrokerCatalogRebootSchedule suivantes pour créer, modifier et supprimer un programme de redémarrage :

Get-BrokerCatalogRebootSchedule
New-BrokerCatalogRebootSchedule
Set-BrokerCatalogRebootSchedule
Remove-BrokerCatalogRebootSchedule
Rename-BrokerCatalogRebootSchedule

Par exemple,

Pour créer un programme de redémarrage des machines virtuelles du catalogue nommé BankTellers, qui débute le 3 février 2022, entre 2 h et 4 h du matin.

 C:\PS> New-BrokerCatalogRebootSchedule -Name BankTellers -CatalogName BankTellers  -StartDate "2022-02-03" -StartTime "02:00" -Enabled $true -RebootDuration 120
 <!--NeedCopy-->

Pour créer un programme de redémarrage des machines virtuelles du catalogue ayant l’UID 17, qui débute le 3 février 2022, entre 1 h et 5 h du matin. Dix minutes avant le redémarrage, chaque machine virtuelle est configurée pour afficher un message avec le titre, WARNING: Reboot pending, et le message Save your work à chaque session utilisateur.
```
 C:\PS> New-BrokerCatalogRebootSchedule -Name 'Update reboot' -CatalogUid 17 -StartDate "2022-02-03" -StartTime "01:00" -Enabled $true -RebootDuration 240 -WarningTitle "WARNING: Reboot pending" -WarningMessage "Save your work" -WarningDuration 10
 
```

Pour renommer le programme de redémarrage de catalogue intitulé Old Name en New Name.

C:\PS> Rename-BrokerCatalogRebootSchedule -Name "Old Name" -NewName "New Name"
<!--NeedCopy-->

Pour afficher tous les programmes de redémarrage de catalogue avec l’UID 1, puis renommer le programme de redémarrage du catalogue avec l’UID 1 en New Name.
```
C:\PS> Get-BrokerCatalogRebootSchedule -Uid 1 | Rename-BrokerCatalogRebootSchedule -NewName "New Name" -PassThru

```
Pour définir le programme de redémarrage de catalogue nommé Accounting afin d’afficher un message intitulé WARNING: Reboot pending et le message Save your work dix minutes avant le redémarrage de chaque machine virtuelle. Le message apparaît à chaque session utilisateur sur cette machine virtuelle.

``` C:\PS> Set-BrokerCatalogRebootSchedule -Name Accounting -WarningMessage “Save your work” -WarningDuration 10 -WarningTitle “WARNING: Reboot pending”
Pour afficher tous les programmes de redémarrage désactivés, puis activer tous les programmes de redémarrage désactivés.
```
 C:\PS> Get-BrokerCatalogRebootSchedule -Enabled $false | Set-BrokerCatalogRebootSchedule -Enabled $true
 
```
Pour définir le programme de redémarrage de catalogue avec l’UID 17 afin d’afficher le message Rebooting in %m% minutes quinze, dix et cinq minutes avant le redémarrage de chaque machine virtuelle.
```
 C:\PS> Set-BrokerCatalogRebootSchedule 17 -WarningMessage "Rebooting in %m% minutes." -WarningDuration 15 -WarningRepeatInterval 5
 
```

Pour configurer le fuseau horaire du catalogue nommé MyCatalog.

 C:\PS> Set-BrokerCatalog -Name "MyCatalog" -TimeZone <TimeZone>
 <!--NeedCopy-->

Ajouter des descriptions à une image

Vous pouvez ajouter des descriptions informatives sur les modifications liées aux mises à jour des images pour les catalogues de machines. Utilisez cette fonctionnalité pour ajouter une description lors de la création d’un catalogue ou lorsque vous mettez à jour 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 de 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 principale associée à un catalogue de machines, utilisez le paramètre MasterImageNote de 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 relatives à chaque image, utilisez la commande Get-ProvSchemeMasterVMImageHistory. Par exemple :
```
 C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 
```

Vous ne pouvez pas effectuer de restauration dans certains scénarios, notamment les suivants. (L’option Restaurer image principale n’est pas visible).

Vous n’êtes pas autorisé à effectuer de restauration.
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 endommagé.
Les modifications apportées par l’utilisateur aux machines du catalogue ne sont pas conservées.
Les machines du catalogue sont en cours d’exécution.

Réinitialiser le disque d’OS

Utilisez la commande PowerShell Reset-ProvVMDisk pour réinitialiser le disque d’OS d’une machine virtuelle persistante dans un catalogue de machines créé par MCS. Actuellement, cette fonctionnalité est applicable à AWS, Azure, XenServer et Google Cloud. Environnements de virtualisation SCVMM et VMware.

Pour exécuter correctement la commande PowerShell, assurez-vous que :

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

Procédez comme suit pour réinitialiser le disque d’OS :

Ouvrez une fenêtre PowerShell.
Exécutez asnp citrix* pour charger des modules PowerShell spécifiques à Citrix.
Exécutez la commande PowerShell Reset-ProvVMDisk de l’une des manières suivantes :
- Spécifiez la liste des machines virtuelles sous forme de liste séparée par des virgules et effectuez la réinitialisation sur chaque machine virtuelle :
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 
```
- Spécifiez la liste des machines virtuelles sous forme de sortie de la commande Get-ProvVM et effectuez la réinitialisation sur chaque machine virtuelle :
```
 (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 
```
- Spécifiez une seule machine virtuelle par son nom :
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 
```
- Créez des tâches de réinitialisation distinctes pour chacune des machines virtuelles 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 de la capacité de l’hyperviseur et la vérification de la connexion pour chaque machine virtuelle.
```
 Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 
```
Une invite de confirmation apparaît, répertoriant les machines virtuelles à 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 que vous appuyez sur Entrée, aucune autre action n’aura lieu.

Remarque :

Ne retirez pas les machines virtuelles du mode de 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 entreprendrait et quitter sans effectuer 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
 
```
- Fournissez le paramètre -Confirm:$false :
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 
```
- 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
 
```
Exécutez Get-ProvTask pour obtenir l’état des tâches renvoyées par la commande Reset-ProvVMDisk.

Modifier le paramètre réseau pour 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 compatible avec 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 :

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

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

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

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

Gérer les versions d’un catalogue de machines

Lorsqu’un catalogue de machines MCS est mis à jour à l’aide de 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 des commandes PowerShell. Vous pouvez :

Voir la liste des versions d’un catalogue de machines
Utiliser n’importe quelle 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 maximum de versions à conserver par le catalogue de machines (la valeur par défaut est 99)

Une version inclut les informations suivantes relatives à 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 consulter les détails de configuration des différentes versions d’un catalogue de machines :
```
 Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 
```
Pour consulter les détails de configuration d’une version spécifique d’un catalogue de machines :
```
 Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 
```
Pour voir le nombre total de versions associées à un catalogue de machines :

``` (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
Pour utiliser une version précédente afin de mettre à jour le catalogue de machines :
```
 Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
 
```
Pour supprimer manuellement une version non utilisée par une machine virtuelle de ce catalogue de machines :
```
 Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 
```
Pour définir le nombre maximum de versions à conserver par le catalogue de machines (la valeur par défaut est 99). Ce paramètre est appliqué à tous les catalogues. Par exemple, dans ce cas, un maximum de 15 versions seront conservées pour tous les catalogues fournis par MCS.
```
 Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 
```

Si le nombre de versions atteint le nombre maximum de versions, aucune nouvelle version ne peut être créée si d’anciennes versions sont utilisées par l’une des machines virtuelles du catalogue de machines. Effectuez alors l’une des opérations suivantes :

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

Convertissez un catalogue de machines non basé sur un profil de machine vers un catalogue de machines basé sur un profil de machine

Vous pouvez utiliser une machine virtuelle, une spécification de modèle (dans le cas d’Azure) ou un modèle de lancement (dans le cas d’AWS) comme entrée de profil de machine pour convertir un catalogue de machines non basé sur un profil de machine vers un catalogue de machines basé sur un profil de machine. Les nouvelles machines virtuelles ajoutées au catalogue utilisent les valeurs des propriétés du profil de la machine, à moins qu’elles ne soient remplacées par des propriétés personnalisées explicites.

Remarque :

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

Pour ce faire :

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

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

Dans le cas d’Azure :

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

Dans le cas d’AWS :

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

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

Vous pouvez réinitialiser les informations d’identité des comptes informatiques actifs présentant 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 mise en œuvre est applicable aux catalogues de machines MCS persistants et non persistants.

Remarque :

Actuellement, cette fonctionnalité n’est prise en charge que pour les environnements de virtualisation Azure et VMware.

Conditions

Prenez compte des points suivants pour réinitialiser correctement le disque d’identité :

Éteignez et réglez la machine virtuelle 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é :

Ouvrez la fenêtre PowerShell.
Exécutez asnp citrix* pour charger des modules PowerShell propres à Citrix.
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 les commandes suivantes dans l’ordre suivant :
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 
```
  Description des paramètres utilisés dans la commande :
  - IdentityAccountName : nom du compte d’identité qui doit être réparé.
  - PrivilegedUserName : compte utilisateur disposant d’une autorisation d’écriture sur le fournisseur d’identité (AD ou AzureAD).
  - PrivilegedUserPassword : mot de passe pour PrivilegedUserName.
  - Target : cible de l’action de réparation. Cela peut être IdentityInfo pour réparer le mot de passe/la clé de confiance du compte, et UserCertificate pour réparer les attributs du certificat utilisateur des identités de machines jointes à AzureAD hybride.
```
 Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -ResetIdentityInfo
 
```
  Le paramètre ResetIdentityInfo réinitialise les éléments suivants :
  - Mot de passe et clés de confiance : si la machine virtuelle est jointe au domaine AD (pour la documentation DaaS uniquement)
  - Clés de confiance uniquement : si la machine virtuelle n’est pas jointe au domaine AD (pour la documentation DaaS uniquement)
  - Mot de passe uniquement : si la machine virtuelle est jointe au domaine AD (pour la documentation CVAD sur site uniquement)
- Pour réinitialiser toutes les configurations du disque d’identité, exécutez ces commandes dans l’ordre suivant :
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 
```
```
 Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 
```
Tapez y pour confirmer l’action. Vous pouvez également ignorer l’invite de confirmation à l’aide du paramètre -Force. Par exemple :
```
Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force

```
Exécutez Get-ProvVM -ProvisioningSchemeName <name -VMName <name> pour vérifier les paramètres de disque d’identité mis à jour. Les attributs du disque d’identité (par exemple, IdentityDiskId) doivent être mis à jour. 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é est actuellement applicable à :

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

Exigences

Les conditions requises pour modifier la configuration du cache sont les suivantes :

Effectuez la mise à jour vers la dernière version du VDA (2308 ou version 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 un minimum de 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 une fois la modification apportée. Les machines virtuelles existantes ne sont pas affectées par ces modifications.

Dépannage

Pour les machines affichant un « état d’alimentation inconnu », consultez l’article CTX131267 pour plus d’informations.
Pour réparer les machines virtuelles qui affichent en permanence un état d’alimentation inconnu, consultez l’article How to fix machine virtuelles that continuously show an unknown power state.

Autres ressources

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

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

Gérer les catalogues de machines

March 25, 2024

Contributeur:

March 25, 2024

Contributeur:

Dans cet article

Introduction
Gérer les catalogues de machines
Utiliser Web Studio
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
Gérer les comptes d’ordinateurs Active Directory dans un catalogue
Mettre un catalogue à jour
Modifier le niveau fonctionnel ou annuler la modification
Cloner un catalogue
Organiser les catalogues sous forme de dossiers
Utiliser PowerShell
Récupérer les erreurs et les avertissements associés à un catalogue
Activer le calendrier de redémarrage unique
Ajouter des descriptions à une image
Réinitialiser le disque d’OS
Modifier le paramètre réseau pour un schéma de provisioning existant
Gérer les versions d’un catalogue de machines
Convertissez un catalogue de machines non basé sur un profil de machine vers un 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
Dépannage
Autres ressources

Cela vous a-t-il été utile ?