Documentation produit
Citrix DaaS™
Voir PDF

Gérer un catalogue VMware

March 25, 2026
Contributeur: 
C 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 de virtualisation VMware.

Remarque :

Avant de gérer un catalogue VMware, vous devez terminer la création d’un catalogue VMware. Consultez Créer un catalogue VMware.

Mettre à jour les machines virtuelles provisionnées vers l’état actuel du schéma de provisioning

La commande Set-ProvScheme modifie le schéma de provisioning. Cependant, elle n’affecte pas les machines virtuelles existantes. À l’aide de la commande PowerShell Set-ProvVMUpdateTimeWindow, vous pouvez appliquer le schéma de provisioning actuel à une machine virtuelle persistante ou non persistante existante, ou à un ensemble de machines virtuelles. Cette fonctionnalité s’applique aux catalogues de machines basés sur un profil de machine et non basés sur un profil de machine.

Vous pouvez mettre à jour :

  • VMCpuCount : Propriété du schéma de provisioning
  • VMMemoryMB : Propriété du schéma de provisioning
  • ID de dossier : Propriété personnalisée
  • Mappage de sous-réseau : Propriété du schéma de provisioning
  • Version matérielle de la machine virtuelle : Uniquement pour les catalogues de machines basés sur un profil de machine
  • Profil de machine : Uniquement pour les catalogues de machines basés sur un profil de machine

Vous pouvez mettre à jour :

  • Une seule machine virtuelle
  • Une liste de machines virtuelles spécifiques ou toutes les machines virtuelles existantes associées à un ID de schéma de provisioning
  • Une liste de machines virtuelles spécifiques ou toutes les machines virtuelles existantes associées à un nom de schéma de provisioning (nom du catalogue de machines)

Avant de mettre à jour les machines virtuelles existantes

  1. Vérifiez la configuration des machines virtuelles existantes. Par exemple :

    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
<!--NeedCopy-->

  2. Mettez à jour le schéma de provisioning. Par exemple :

    $customProperties=<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Property xsi:type="StringProperty" Name="FolderId" Value="FOLDER_ID"/></CustomProperties>
$memoryMb=<DOUBLE THE "UPDATE" MACHINE PROFILE>
Set-ProvScheme -ProvisioningSchemeName my-catalog -VMCpuCount 4 -VmMemoryMb $memoryMb -CustomProperties $customerProperties -NetworkMapping @{"1" = "<A_NETWORK_PATH_FROM_THE_HOSTING_UNIT>"} -MachineProfile "<PATH_TO_UPDATE_MACHINE_PROFILE>"
<!--NeedCopy-->

  3. Vérifiez si la propriété actuelle de la machine virtuelle correspond au schéma de provisioning actuel et s’il existe une action de mise à jour en attente sur la machine virtuelle. Par exemple :

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

    Vous pouvez également trouver des machines virtuelles avec une version particulière. Par exemple :

    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
<!--NeedCopy-->

Demander des mises à jour pour les machines virtuelles existantes à appliquer au prochain redémarrage

  1. Exécutez les commandes suivantes pour mettre à jour les machines virtuelles existantes et appliquer les mises à jour au prochain redémarrage.

    • Pour mettre à jour toutes les machines virtuelles existantes. Par exemple :

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • Pour mettre à jour une liste de machines virtuelles spécifiques. Par exemple :

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • Pour mettre à jour les machines virtuelles en fonction de la sortie de Get-ProvVM. Par exemple :

      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    Remarque :

    • StartsNow indique que l’heure de début planifiée est l’heure actuelle.
    • DurationInMinutes avec un nombre négatif (par exemple, –1) indique qu’il n’y a pas de limite supérieure à la fenêtre de temps de la planification.

  2. Recherchez les machines virtuelles avec une mise à jour planifiée. Par exemple :

    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
<!--NeedCopy-->

  3. Redémarrez les machines virtuelles. Lors du prochain démarrage, les modifications de propriété sont appliquées aux machines virtuelles existantes. Vous pouvez vérifier l’état mis à jour à l’aide de la commande suivante. Par exemple :

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

Annuler la mise à jour de la configuration

Vous pouvez également annuler une mise à jour de configuration d’une seule machine virtuelle, de plusieurs machines virtuelles ou d’un catalogue entier. Pour annuler une mise à jour de configuration :

  1. Exécutez Clear-ProvVMUpdateTimeWindow. Par exemple :

    • Pour annuler la mise à jour de configuration planifiée pour une seule machine virtuelle :

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 <!--NeedCopy-->

    • Pour annuler la mise à jour de configuration planifiée pour plusieurs machines virtuelles :

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 <!--NeedCopy-->

      Remarque :

      Les machines virtuelles doivent provenir du même catalogue.

Mettre à jour l’ID de dossier d’un catalogue de machines

Vous pouvez mettre à jour l’ID de dossier d’un catalogue de machines MCS en spécifiant le FolderId dans les propriétés personnalisées de la commande Set-ProvScheme. Les machines virtuelles créées après la mise à jour de l’ID de dossier sont créées sous ce nouvel ID de dossier. Si cette propriété n’est pas spécifiée dans CustomProperties, les machines virtuelles sont créées sous le dossier où se trouve l’image principale.

Effectuez les étapes suivantes pour mettre à jour l’ID de dossier d’un catalogue de machines.

  1. Ouvrez un navigateur Web et entrez l’URL du vSphere Web Client.
  2. Entrez les informations d’identification et cliquez sur Connexion.
  3. Créez un dossier de placement de machines virtuelles dans le vSphere Web Client.
  4. Ouvrez une fenêtre PowerShell.
  5. Exécutez asnp citrix®* pour charger les modules PowerShell spécifiques à Citrix.

  6. Spécifiez le FolderID dans les CustomProperties de Set-ProvScheme. Dans cet exemple, la valeur de l’ID de dossier est group-v2406.

    Set-ProvScheme -ProvisioningSchemeUid "50bb319c-2e83-4a37-9ea1-94f630687372" -CustomProperties "<CustomProperties xmlns=""http://schemas.citrix.com/2014/xd/machinecreation"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""><Property xsi:type=""StringProperty"" Name=""FolderId"" Value=""group-v2406"" /></CustomProperties>"
<!--NeedCopy-->
  7. Ajoutez une machine virtuelle au catalogue de machines à l’aide de Studio.
  8. Vérifiez la nouvelle machine virtuelle sur le vSphere Web Client. La nouvelle machine virtuelle est créée sous le nouveau dossier.

Trouver l’ID de dossier à l’aide des commandes PowerShell

Utilisez la commande PowerShell Get-HypConfigurationDataForItem pour trouver l’ID de dossier d’un dossier existant dans un hyperviseur VMware.

Créez une connexion d’hébergement et un groupe de ressources pour un hyperviseur VMware. Ensuite, effectuez les étapes suivantes pour trouver l’ID de dossier d’un dossier sur cet hyperviseur.

  1. Déterminez le chemin XDHyp vers la racine de l’arborescence des dossiers de machines virtuelles. Par exemple :

    XDHyp:\Connections\VMwareConn\Datacenter.datacenter
<!--NeedCopy-->

  2. Utilisez Get-HypConfigurationDataForItem pour récupérer la structure de l’arborescence. Par exemple :

    Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
<!--NeedCopy-->

  3. Exécutez la commande suivante pour identifier l’ID de dossier à partir de la sortie XML. Dans cet exemple, recherchez l’ID de dossier de ExampleFolder dans la sortie XML.

    $result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
$result.VmPlacementFolder
<!--NeedCopy-->

    Sortie XML :

    <?xml version="1.0" encoding="utf-16"?>
<CtxVmPlacementFolder xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Name>vm</Name>
<Id>group-v4</Id>
<SubFolder>
<CtxVmPlacementFolder>
  <Name>vCLS</Name>
  <Id>group-v75</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>MyOtherFolder</Name>
  <Id>group-v1110</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>ExampleFolder</Name>
  <Id>group-v4658</Id>
  <SubFolder />
</CtxVmPlacementFolder>
</SubFolder>
</CtxVmPlacementFolder>
<!--NeedCopy-->

Trouver l’ID de dossier dans vSphere

Accédez au MOB sur n’importe quel système de serveur ESXi ou vCenter pour trouver l’ID de dossier des machines virtuelles.

Le Managed Object Browser (MOB) est une application serveur Web intégrée à tous les systèmes de serveurs ESX/ESXi et vCenter. Cet utilitaire vSphere vous permet d’afficher des informations détaillées sur des objets tels que les machines virtuelles, les banques de données et les pools de ressources.

  1. Ouvrez un navigateur Web et entrez http://x.x.x.x/mob, où x.x.x.x est l’adresse IP du serveur vCenter ou de l’hôte ESX/ESXi. Par exemple, https://10.60.4.70/mob.
  2. Sur la page Accueil du MOB, cliquez sur la valeur de la propriété content.
  3. Cliquez sur la valeur de rootFolder.
  4. Cliquez sur la valeur de childEntity.
  5. Cliquez sur la valeur de vmFolder.
  6. Vous pouvez trouver l’ID de dossier dans la valeur de childEntity.

Identifier les ressources créées par MCS

Voici les balises que MCS ajoute aux ressources sur la plateforme VMware. Les balises du tableau sont représentées sous la forme « clé » : « valeur ».

Nom de la ressource Balise
Machine virtuelle de préparation “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “XdConfig:”XdProvisioned=True”
Machine virtuelle dans le catalogue “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “XdConfig:”XdProvisioned=True”

Plus d’informations

Gérer un catalogue VMware
March 25, 2026
Contributeur: 
C C
March 25, 2026
Contributeur: 
C 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.