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

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 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.

   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 Azure Compute Gallery pour placer les images dans la galerie.

3. 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.
4. Sur la page Résumé, vérifiez les détails. Cliquez sur Terminer.

Vous pouvez consulter l’historique des modifications d’image 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’image

Vous pouvez modifier et supprimer les définitions et les versions d’image pour gérer l’utilisation des différentes versions et définitions d’image 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 la 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]
<!--NeedCopy-->

Ou,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--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
<!--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 maître 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-->
   

3. 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-->
   

4. Supprimez la spécification de version d’image maître. Par exemple,

   $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
   
   Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
   <!--NeedCopy-->
   

   Remarque :

   Une spécification de version d’image maître ne peut être supprimée que lorsqu’il n’y a pas de spécification de version d’image préparée associée.

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

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

6. 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
   <!--NeedCopy-->
   

7. 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 d’image 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, des spécifications de version d’image préparée et du schéma de provisionnement

• 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’image 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-->
    

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

  • Pour répertorier toutes les spécifications de version d’image préparée dans une version d’image,

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

  • Pour répertorier 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 répertorier les spécifications de version d’image préparée dans une version d’image, 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ée 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-->
    

• Obtenir les détails du schéma de provisionnement à 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-->
  

• Obtenir l’historique des spécifications de version d’image préparée d’un schéma de provisionnement à 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

• Gestion des images