Documentation produit
Citrix DaaS™
Voir PDF

Gérer un catalogue Nutanix

May 4, 2026
Contributeur: 
C

Gérer les catalogues de machines décrit les assistants qui gèrent un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements Nutanix AHV Prism Central.

Remarque :

Avant de gérer un catalogue de machines sur Nutanix AHV Prism Central, vous devez terminer la création d’un catalogue de machines sur Nutanix AHV Prism Central. Consultez Créer un catalogue Nutanix.

Vous pouvez gérer un catalogue de machines sur Nutanix AHV Prism Central à l’aide de :

Utiliser Studio

Voici les options pour gérer un catalogue de machines sur Nutanix AHV Prism Central à l’aide de Studio :

Option Description
Ajouter des machines Créez et ajoutez des machines virtuelles au catalogue de machines.
Supprimer le catalogue de machines Supprimez un catalogue de machines. Vous pouvez choisir de supprimer les machines virtuelles en même temps ou de laisser les machines virtuelles persistantes intactes.
Modifier l’image principale Modifiez l’image principale utilisée comme modèle pour toutes les machines virtuelles du catalogue.
Ajouter ou modifier un profil de machine Modifiez la version du modèle du profil de machine ou ajoutez un profil de machine à un catalogue existant.
Gérer l’ensemble de configurations Liez un catalogue à un ensemble de configurations Workspace Environment Management™ ou passez à une configuration différente.
Modifier le catalogue de machines Modifiez les configurations du catalogue, telles que les cartes réseau et les machines virtuelles.
Afficher les machines Accédez au nœud Rechercher pour afficher toutes les machines virtuelles appartenant au catalogue.
Renommer le catalogue de machines Modifiez le nom du catalogue.
Mettre à niveau les VDA Mettez à niveau les VDA par catalogue. Cette fonctionnalité s’applique uniquement aux machines persistantes statiques.
Modifier le niveau fonctionnel Sélectionnez le niveau fonctionnel minimal pour le catalogue. La définition d’un niveau fonctionnel rend toutes les fonctionnalités disponibles.
Tester le catalogue de machines Vérifiez si le catalogue contient des erreurs ou des avertissements.
Gérer les balises Créez, modifiez et supprimez des balises. Sélectionnez les balises à appliquer au catalogue.
Déplacer le catalogue de machines Déplacez le catalogue vers un autre dossier.

Remarque :

Actuellement, l’option Cloner n’est pas disponible.

Modifier l’image principale

Pour modifier l’image principale d’un catalogue, procédez comme suit :

  1. Sur la page Catalogues de machines, cliquez avec le bouton droit sur le catalogue de machines que vous souhaitez mettre à jour, puis sélectionnez Modifier l’image principale.

  2. Sur la page Modifier l’image principale, cliquez sur Sélectionner une image.

    Connexion hôte AHV Prism Central

  3. Sur la page Sélectionner une image, développez un modèle et sélectionnez une version de modèle à utiliser comme image principale. Vous pouvez filtrer les modèles de machines par nom.
  4. Sur la page Stratégie de déploiement, choisissez le moment où vous souhaitez que la mise à jour soit appliquée.

Remarque :

  • Pour un catalogue non persistant provisionné par MCS avec le plug-in de connexion hôte Nutanix AHV Prism Central, la mise à jour de l’image principale pour basculer la configuration de démarrage entre Legacy et UEFI empêche les machines virtuelles existantes de démarrer lors de leur prochain démarrage.
  • Lorsque vous mettez à jour l’image principale, seul le disque du système d’exploitation est mis à jour. Les propriétés matérielles restent inchangées. Pour mettre à jour les propriétés matérielles, consultez Ajouter ou modifier le profil de machine, Modifier les cartes réseau et Modifier la configuration des machines virtuelles.

Ajouter ou modifier le profil de machine

Pour ajouter ou modifier un profil de machine pour un catalogue, procédez comme suit :

  1. Sur la page Catalogues de machines, cliquez avec le bouton droit sur le catalogue de machines que vous souhaitez modifier, puis sélectionnez Modifier le catalogue de machines.

  2. Sur la page Profil de machine,

    • Si le catalogue de machines possède déjà un profil de machine, cliquez sur l’icône en forme de crayon pour sélectionner une version de modèle de profil de machine différente. Vous pouvez filtrer par nom de modèle. Confirmez les paramètres du profil de machine.
    • Si le catalogue de machines ne possède pas de profil de machine, sélectionnez Utiliser un profil de machine et sélectionnez un profil de machine. Confirmez les paramètres du profil de machine.
  3. La page Machines virtuelles doit refléter la configuration mise à jour conformément à la version du modèle de profil de machine sélectionnée.

Modifier les cartes réseau

Pour modifier les cartes réseau d’un catalogue, procédez comme suit :

  1. Sur la page Catalogues de machines, cliquez avec le bouton droit sur le catalogue de machines que vous souhaitez modifier, puis sélectionnez Modifier le catalogue de machines.

  2. Sur la page Cartes réseau :

    • Sélectionnez un type de carte réseau.

    • Si le catalogue sélectionné a été créé avec un profil de machine, le nombre de cartes réseau est cohérent avec le nombre de cartes réseau du profil de machine et ne peut pas être modifié. Sélectionnez un réseau virtuel associé pour chaque carte réseau.

      Carte réseau AHV Prism Central avec profil de machine

    • Si le catalogue sélectionné a été créé sans profil de machine, cliquez sur Ajouter une carte réseau pour augmenter le nombre de cartes réseau ou cliquez sur Supprimer pour supprimer les cartes réseau sélectionnées. Cochez ou décochez les cases pour sélectionner les cartes réseau, et choisissez un réseau virtuel associé pour chaque carte réseau.

      Carte réseau AHV Prism Central sans profil de machine

Modifier la configuration des machines virtuelles

Pour modifier la configuration des machines virtuelles, y compris la mémoire, le nombre de CPU et le nombre de cœurs par vCPU, procédez comme suit :

  1. Sur la page Catalogues de machines, cliquez avec le bouton droit sur le catalogue de machines que vous souhaitez modifier, puis sélectionnez Modifier le catalogue de machines.

  2. Sur la page Machines virtuelles, utilisez les flèches haut ou bas, ou saisissez directement des valeurs pour ajuster la mémoire, le nombre de CPU et le nombre de cœurs par vCPU pour les machines virtuelles.

    Connexion hôte AHV Prism Central

Utiliser PowerShell

Modifier l’image principale

Les paramètres requis sont :

  • ProvisioningSchemeName : Nom du schéma de provisioning à modifier.
  • MasterImage : Chemin littéral vers la nouvelle image principale.

Exécutez la commande suivante. Par exemple :


Set-ProvSchemeMetadata  -Name "ImageManagementPrep_DoImagePreparation" -ProvisioningSchemeName "<ProvisioningSchemeName>" -Value "True"

Publish-ProvMasterVMImage  -MasterImageVM "<Literal path to the new master image- template version> -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously

<!--NeedCopy-->

Remarque :

Lorsque vous mettez à jour l’image principale, seul le disque du système d’exploitation est mis à jour. Les propriétés matérielles restent inchangées. Pour mettre à jour les propriétés matérielles, consultez Ajouter ou modifier le profil de machine, Modifier les cartes réseau et Modifier la configuration de la carte réseau et de la machine virtuelle.

Ajouter ou modifier le profil de machine

Utilisez la commande Set-ProvScheme :

  • Pour mettre à jour un catalogue avec un nouveau profil de machine, ou
  • Pour mettre à jour un catalogue existant qui n’a pas de profil de machine afin de commencer à utiliser le profil de machine comme source de spécification matérielle.

Remarque :

Cela ne met pas à jour la spécification matérielle des machines virtuelles existantes dans le catalogue. Seules les nouvelles machines virtuelles ajoutées au catalogue auront la spécification matérielle du profil de machine donné.

Pour modifier le profil de machine ou convertir un catalogue existant pour commencer à utiliser le profil de machine :


Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `                  
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
               -NetworkMapping @{"0"="XDHyp:\HostingUnits\<Hosting unit name>\Clusters.folder\<Cluster Name>.cluster\<Network name>.network"} 

<!--NeedCopy-->

Le profil de machine doit avoir au moins une carte réseau, et le nombre de cartes réseau dans le profil de machine doit correspondre aux mappages de sous-réseau dans NetworkMapping.

Le nombre total de cartes réseau pour la version du modèle peut être obtenu à partir des AdditionalData de son élément d’inventaire en utilisant ce qui suit :


$tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
$tv.AdditionalData.TotalNics

<!--NeedCopy-->

Pour modifier le profil de machine avec une spécification matérielle remplacée :

Certaines configurations peuvent être configurées à l’aide de paramètres de ligne de commande spécifiques. Ces paramètres de ligne de commande, tels que VMCpuCount et VMMemoryMB, et CPUCores dans les CustomProperties, priment sur les valeurs de la version du modèle de profil de machine.


$customProperties = @"
    <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <StringProperty Name="ClusterId" Value="00062c63-1fb0-58c9-4fc8-5c2573352378" />
        <StringProperty Name="CPUCores" Value="2" />
    </CustomProperties>
"@

Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion" `
               -CustomProperties $customProperties `
               -VMCpuCount 4 `
               -VMMemoryMB 4096

<!--NeedCopy-->

Modifier la configuration de la carte réseau et de la machine virtuelle

Les paramètres requis sont :

  • ProvisioningSchemeName : Nom du schéma de provisioning à modifier.
  • NetworkMapping : Mappage réseau mis à jour.

Exécutez la commande suivante. Par exemple :


Set-ProvScheme  -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ClusterId`" Value=`"000xxxx-1fb0-xxxxx-4fc8-5c257335xxxx`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>"  -NetworkMapping @{"6"="XDHyp:\HostingUnits\<Hosting Unit Name>\Clusters.folder\<Cluster Name>\<Network name>.network"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -VMCpuCount 4

<!--NeedCopy-->

Migrer les catalogues de machines vers la connexion d’hôte Nutanix AHV Prism Central gérée par Citrix

Migrez vos catalogues de machines Citrix et leurs machines virtuelles associées des connexions d’hôte Nutanix AHV (pour Prism Element) et Nutanix AHV PC (pour NC2 sur Azure) existantes vers la connexion d’hôte Nutanix AHV Prism Central gérée par Citrix. Pour la migration, utilisez des commandes PowerShell, qui incluent également des options de restauration rapide en cas de problèmes, et des commandes pour nettoyer les ressources sources après la migration.

Avantages

  • Interruption minimisée : Vous passez en douceur au plug-in Nutanix AHV Prism Central. Cela a un impact minimal sur vos déploiements existants.
  • Chemin de mise à niveau transparent : Il vous offre un chemin clair et pris en charge pour mettre à niveau votre infrastructure et tirer parti de la nouvelle interface de gestion.
  • Intégrité et sécurité des données : Les options de restauration garantissent que vous rétablissez l’environnement à son état d’origine en cas de problèmes imprévus. Cela réduit les risques.
  • Efficacité des ressources : Vous nettoyez les ressources sources après une migration réussie. Cela optimise le stockage et les frais de gestion.
  • Flexibilité : Il prend en charge la migration pour les catalogues provisionnés par MCS et les technologies tierces. Cela offre une applicabilité plus large.

Applicabilité

Cette fonctionnalité est applicable aux catalogues de machines sous les connexions d’hôte Nutanix AHV (pour Prism Element) et Nutanix AHV PC (pour NC2 sur Azure) :

  • Catalogues de machines gérés par MCS, y compris les types persistants et non persistants.
  • Catalogues de machines gérés uniquement par l’alimentation qui contiennent des machines virtuelles provisionnées par des technologies tierces.

Configuration système requise

  • Version AOS de Nutanix AHV Prism Element (PE) : Vous avez besoin d’un minimum de 6.8.
  • Version de Nutanix Prism Central (PC) : Vous avez besoin d’un minimum de 2024.3.

Remarque :

Nutanix Prism Central 7.3 nécessite AOS 7.3 en raison d’un problème connu de Nutanix.

Limitations

  • Les catalogues PVS ne sont pas pris en charge : Cette fonctionnalité ne prend pas en charge les catalogues de machines créés à l’aide de l’Assistant d’installation Xendesktop de Citrix Provisioning Services (PVS).
  • Restrictions de restauration :
    • N’autorisez la restauration d’un catalogue migré que si vous n’avez pas modifié le catalogue après la migration initiale.
    • Lorsque vous exécutez l’opération « Nettoyer les ressources sources », l’état de la migration est effacé. Cela empêche toute restauration ultérieure.
  • Pas de nouvelle migration : Un catalogue de machines que vous avez déjà migré n’est pas pris en charge pour une nouvelle migration.
  • VM de connexion multi-hôtes : La migration d’un catalogue de machines géré uniquement par l’alimentation qui contient des machines virtuelles importées de plusieurs connexions d’hôte n’est pas prise en charge.

Considérations importantes

  • Gestion des clusters Nutanix : Les clusters Nutanix AHV hébergés doivent être enregistrés auprès d’un Nutanix Prism Central.
  • Création de modèle d’image principale : Pour les catalogues de machines MCS, la commande de migration offre une option permettant de générer une version de modèle de machine virtuelle sur Prism Central à partir de l’instantané d’origine de l’image principale du catalogue de machines. Cette version de modèle de machine virtuelle peut ensuite être utilisée comme image principale MCS des catalogues de machines sous la connexion d’hôte Prism Central. Par défaut, cette option n’est pas activée.
  • Conditions préalables à la restauration :

Pour qu’une restauration réussie soit possible, l’environnement source d’origine (y compris la connexion d’hôte et les disques de base) doit rester inchangé. Vous devez également éviter d’apporter des modifications de configuration au catalogue de machines migré et d’ajouter/supprimer des machines virtuelles tant que la migration n’est pas confirmée comme réussie. Après cette confirmation, vous pouvez effectuer l’opération finale de nettoyage des ressources sources, mais sachez qu’il s’agit d’une étape irréversible qui rendra toute restauration impossible.

Autorisations requises pour la migration et la restauration

Pour migrer des catalogues ou effectuer une restauration, vous avez besoin des autorisations suivantes :

Administrateur Prism Element :

  • Créer une machine virtuelle

Administrateur Prism Central :

  • Créer des modèles de machine virtuelle
  • Supprimer des modèles de machine virtuelle
  • Supprimer un point de récupération de machine virtuelle
  • Supprimer une machine virtuelle

Pour la liste complète des autorisations spécifiques nécessaires pour la connexion d’hôte Nutanix AHV Prism Central gérée par Citrix, consultez Autorisations requises.

Comment migrer

Vous gérez cette fonctionnalité via des cmdlets PowerShell dédiées. Le workflow général implique trois opérations principales : Migration, Restauration et Nettoyage des ressources sources.

Migrer un catalogue de machines

  • Cette opération déplace un catalogue de machines et ses machines virtuelles associées d’une connexion d’hôte Nutanix AHV ou Nutanix AHV PC source vers une connexion d’hôte Nutanix AHV Prism Central gérée par Citrix cible.
  • Pour les catalogues provisionnés par MCS, ce processus crée de nouveaux disques de base dans la connexion cible.
  • Vous pouvez éventuellement choisir de créer un équivalent de machine virtuelle principale (version de modèle de machine virtuelle) dans la connexion cible à partir de l’instantané de l’image principale d’origine.
  1. Créer une nouvelle connexion d’hôte Nutanix AHV Prism Central : Avant la migration, enregistrez le cluster Nutanix AHV hébergé auprès d’un Nutanix Prism Central, et établissez une nouvelle connexion d’hôte Nutanix AHV Prism Central qui pointe vers l’instance Nutanix Prism Central cible. Cette connexion sert de destination pour vos catalogues migrés. Pour plus de détails, consultez Connexion d’hôte Nutanix AHV Prism Central.

  2. Migrer un catalogue de machines existant : Pour les catalogues de machines existants, utilisez la cmdlet PowerShell Switch-ProvCatalog pour lancer la migration vers la connexion d’hôte Nutanix AHV Prism Central gérée par Citrix.

    
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination

<!--NeedCopy-->
    • Remplacez <Catalog_UID> par l’identifiant unique du catalogue de machines que vous souhaitez migrer. Utilisez la cmdlet PowerShell suivante pour localiser le BrokerCatalogUid par nom de catalogue Get-BrokerCatalog -Name <Catalog Name>.
    • DestinationConnection est le nom de la nouvelle connexion d’hôte Nutanix AHV Prism Central créée à l’étape 1.
    • DestinationUnit est le nom que vous donnez à l’unité d’hébergement au sein de la DestinationConnection où résidera le catalogue de machines.
    • Le paramètre -CreateMasterImageAtDestination est facultatif. Il crée une version de modèle de machine virtuelle d’image principale sur le Prism Central cible.

  3. Vérifier l’achèvement de la migration : Après l’exécution de la cmdlet de migration, surveillez l’état de la tâche dans la fenêtre PowerShell pour vous assurer qu’elle se termine avec succès. Lorsque la migration est terminée, le catalogue est déplacé vers la connexion d’hôte cible créée à l’étape 1. Vous devez voir un état « terminé » avec le type de tâche SwitchProvCatalog. Voici les étapes recommandées pour vérifier l’achèvement de la migration :

    • Vérifiez l’état du catalogue dans Studio.
    • Vérifiez que les machines virtuelles du catalogue sont désormais associées à la nouvelle connexion d’hyperviseur de destination.
    • Vérifiez que les machines virtuelles du catalogue affichent l’état d’alimentation correct.
    • Testez la fonctionnalité du catalogue de machines migré en ajoutant ou en supprimant des machines ou en effectuant des opérations d’alimentation pour vous assurer que le catalogue fonctionne correctement.

Restaurer un catalogue migré

Cette opération restaure un catalogue de machines et ses machines virtuelles à leur connexion d’hôte source d’origine. Elle supprime toutes les ressources que vous avez créées pendant le processus de migration.

Important :

Vous n’effectuez une restauration que si vous n’avez pas modifié le catalogue après la migration et que vous n’avez pas exécuté l’opération Nettoyer les ressources sources. La connexion source d’origine reste inchangée et contient toujours ses disques de base.


c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback

<!--NeedCopy-->

Nettoyer les ressources sources

Après une migration réussie, cette opération supprime les ressources sources, par exemple les disques de base, de la connexion d’hyperviseur d’origine.

Important :

Lorsque vous exécutez cette commande, elle efface l’état de la migration. Cela rend les restaurations ultérieures impossibles.


c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources

<!--NeedCopy-->

Vous recevez une invite de confirmation avant de continuer, car cette action est irréversible. Confirmez l’invite pour terminer le nettoyage.

Plus d’informations

Gérer un catalogue Nutanix
May 4, 2026
Contributeur: 
C
May 4, 2026
Contributeur: 
C

Dans cet article

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