Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Gérer les catalogues de machines d’images préparées

April 8, 2026
Contributeur: 
C C

  • Vous pouvez mettre à jour un catalogue de machines MCS existant avec une image préparée différente et gérer les définitions et les versions d’images à l’aide de :

  • Web Studio
  • PowerShell

Utiliser Web Studio

Mettre à jour un catalogue de machines avec une image préparée différente

Pour mettre à jour un catalogue de machines MCS existant avec une image préparée différente, procédez comme suit :

  1. Cliquez sur Catalogues de machines dans le volet de navigation de gauche et sélectionnez un catalogue de machines que vous souhaitez mettre à jour. Cliquez avec le bouton droit de la souris et sélectionnez Modifier l’image préparée.

  2. Sur la page Image, sélectionnez une image préparée. Si nécessaire, ajoutez une note pour l’image préparée sélectionnée.

    Remarque :

    Applicable à Azure : vous pouvez également choisir une image sans ACG activé, puis sélectionner la case à cocher Placer l’image préparée dans la galerie de calcul Azure pour placer les images dans la galerie.

  3. Pour revenir à une image préparée précédemment attribuée, cliquez sur Utiliser l’attribution d’image précédente pour un retour rapide en bas de l’assistant.

    Une nouvelle fenêtre s’ouvre et affiche une liste de toutes les attributions d’images historiques disponibles. Lorsque vous sélectionnez une image dans la liste, la version correspondante est automatiquement sélectionnée dans l’arborescence des images préparées sur la page d’image.

  4. Sur la page Stratégie de déploiement, sélectionnez le moment où vous souhaitez mettre à jour ce catalogue avec l’image préparée sélectionnée.
  5. Sur la page Résumé, vérifiez les détails. Cliquez sur Terminer.

Vous pouvez consulter l’historique des modifications d’images apportées à un catalogue. Pour consulter l’historique, procédez comme suit :

  1. Sélectionnez un catalogue de machines.
  2. Sous l’onglet Propriétés du modèle, dans le champ Image préparée, cliquez sur Afficher l’historique des images.

Gérer les définitions et les versions d’images

Vous pouvez modifier et supprimer les définitions et les versions d’images pour gérer l’utilisation des différentes versions et définitions d’images créées.

Modifier une définition d’image

Vous pouvez modifier le nom et la description d’une définition d’image.

Pour modifier une définition d’image, procédez comme suit :

  1. Accédez au nœud Images, sélectionnez une définition d’image, puis sélectionnez Modifier la définition d’image.

Modifier une version d’image

Vous pouvez modifier la description d’une version d’image pour spécifier l’objectif de cette version d’image.

Pour modifier une version d’image, procédez comme suit :

  1. Accédez au nœud Images, sélectionnez une version d’image, puis sélectionnez Modifier la description.

Supprimer une version d’image

Pour supprimer une version d’image, procédez comme suit :

  1. Accédez au nœud Images, sélectionnez une version d’image, puis sélectionnez Supprimer la version d’image.

Remarque :

Vous ne pouvez pas supprimer une version d’image si elle est utilisée par un catalogue de machines.

  • Supprimer une définition d’image

  • Pour supprimer une définition d’image, procédez comme suit :

    1. Accédez au nœud Images, sélectionnez une définition d’image, puis sélectionnez Supprimer la définition d’image.

Remarque :

Vous ne pouvez pas supprimer une définition d’image si elle contient une version d’image.

Utiliser PowerShell

Mettre à jour un catalogue à l’aide d’une spécification de version d’image préparée

Vous pouvez mettre à jour un catalogue à l’aide de la commande Set-ProvSchemeImage. Par exemple,

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Ou,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell pour mettre à jour un catalogue :

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously -ImageAssignmentNote "Update from VST team"
<!--NeedCopy-->

Obtenir l’historique des modifications d’images pour le schéma de provisioning 

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--NeedCopy-->

Supprimer la définition d’image, la version d’image et la spécification de version d’image préparée

Tenez compte des points suivants avant de supprimer une définition d’image, une version d’image et une spécification de version d’image préparée :

  • Une définition d’image ne peut pas être supprimée si elle contient une version d’image.
  • Une version d’image ne peut pas être supprimée si elle contient une spécification de version d’image.
  • Une spécification de version d’image principale ne peut pas être supprimée si elle est utilisée par une autre spécification de version d’image préparée.
  • Une spécification de version d’image préparée ne peut pas être supprimée si elle est utilisée par un catalogue de machines MCS.
  • Une unité d’hébergement ne peut pas être supprimée si elle est utilisée par une autre spécification de version d’image préparée.

Les étapes détaillées sont les suivantes :

  1. Supprimez le catalogue de machines. Par exemple,

    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
<!--NeedCopy-->

  2. Supprimez la spécification de version d’image préparée partagée. Par exemple,

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->
    1. Supprimez une spécification de version d’image préparée. Par exemple,
     $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

 Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
 <!--NeedCopy-->
      1. Supprimez la spécification de version d’image principale. Par exemple,
     $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

 Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
 <!--NeedCopy-->

    • Remarque :

      La spécification de version d’image principale ne peut être supprimée que s’il n’y a pas de spécification de version d’image préparée associée.

  1. Supprimez une version d’image. Par exemple,

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
<!--NeedCopy-->

  2. Supprimez la configuration de la définition d’image dans la connexion d’hébergement spécifiée. Par exemple,

    ```

  • Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

    ```

  1. Supprimez une définition d’image. Par exemple,

    Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->
    • Exemple de l’ensemble complet de commandes PowerShell lorsque l’image préparée n’est pas partagée entre les unités d’hébergement :
Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

    -  $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

    -  Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell lorsque l’image préparée est partagée entre les unités d’hébergement :

    -  Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> 
-HostingUnitName AzureWest

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

    -  Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Gérer la définition et la version d’image

Vous pouvez renommer et modifier une définition d’image, et modifier une version d’image.

  • Renommez une définition d’image à l’aide de la commande Rename-ProvImageDefinition. Par exemple :

     Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
 <!--NeedCopy-->

    Ou,

     Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
 <!--NeedCopy-->

  • Modifiez une définition d’image à l’aide de la commande Set-ProvImageDefinition. Par exemple :

     Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    Ou,

     Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
 <!--NeedCopy-->

  • Modifiez une version d’image à l’aide de la commande Set-ProvImageVersion. Par exemple :

     Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    Ou,

     Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
 <!--NeedCopy-->

Obtenir les détails de la définition d’image, de la version d’image, de la spécification de version d’image préparée et du schéma de provisioning

  • Obtenez les détails de la définition d’image à l’aide de la commande Get-ProvImageDefinition. Par exemple :

     Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
 <!--NeedCopy-->

  • Obtenez les détails de la version d’image à l’aide de la commande Get-ProvImageVersion. Par exemple :

    • Pour lister les versions d’images dans une définition d’image,

       Get-ProvImageVersion -ImageDefinitionUid <Guid>
 <!--NeedCopy-->

      Ou,

       Get-ProvImageVersion -ImageDefinitionName <string>
 <!--NeedCopy-->

    • Pour obtenir le détail d’une version d’image,

       Get-ProvImageVersion -ImageVersionUid <Guid>
 <!--NeedCopy-->

      Ou,

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
 <!--NeedCopy-->

  • Obtenez la spécification de version d’image préparée à l’aide de la commande Get-ProvImageVersionSpec. Par exemple :

    • Pour lister toutes les spécifications de version d’image préparées dans une version d’image,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid>
 <!--NeedCopy-->

    • Pour lister les spécifications de version d’image principale dans une spécification de version d’image préparée,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
 <!--NeedCopy-->

    • Pour lister les spécifications de version d’image préparées dans une version d’image, qui est associée à une image principale,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
 <!--NeedCopy-->

    • Pour obtenir les spécifications de version d’image préparées réussies dans une version d’image,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
 <!--NeedCopy-->

    • Pour obtenir le détail d’une spécification de version d’image préparée,

       Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
 <!--NeedCopy-->

  • Obtenez les détails du schéma de provisioning à l’aide de la commande Get-ProvScheme. Par exemple :

     Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

  • Obtenez l’historique des spécifications de version d’image préparées d’un schéma de provisioning à l’aide de la commande Get-ProvSchemeImageVersionSpecHistory. Par exemple :

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

Plus d’informations

Gérer les catalogues de machines d’images préparées
April 8, 2026
Contributeur: 
C C
April 8, 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.