Gérer les catalogues de machines d’images préparées
Vous pouvez mettre à jour un catalogue de machines MCS avec une autre image préparée et gérer les définitions et les versions d’images à l’aide des méthodes suivantes :
- Studio
- PowerShell
Utiliser Studio
Mettre à jour un catalogue de machines avec une autre image préparée
Pour mettre à jour un catalogue de machines MCS existant avec une autre image préparée, procédez comme suit :
- Cliquez sur Catalogues de machines dans le panneau de navigation de gauche et sélectionnez le 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.
-
Sur la page Image, sélectionnez une image préparée.
Remarque
Applicable à Azure : vous pouvez également choisir une image avec ACG non activé, puis sélectionner la case à cocher Placer l’image préparée dans Azure Compute Gallery pour placer l’image dans la galerie.
- 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.
- 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 :
- Sélectionnez un catalogue de machines.
- Dans 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 :
- 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 celle-ci.
Pour modifier une version d’image, procédez comme suit :
- 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 :
- 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 :
- 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, les opérations suivantes peuvent être effectuées :
Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->
Or,
Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->
Exemple d’ensemble complet de commandes Powershell permettant de 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
Avant de supprimer une définition d’image, une version d’image et une spécification de version d’image préparée, tenez compte des points suivants :
- 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é hôte ne peut pas être supprimée si elle est utilisée par une autre spécification de version d’image préparée.
Voici le détail des étapes :
-
Supprimez le catalogue de machines. Par exemple, les opérations suivantes peuvent être effectuées :
Remove-ProvScheme -ProvisioningScheneName decouplingCatalog <!--NeedCopy-->
-
Supprimez la spécification de version d’image préparée partagée. Par exemple, les opérations suivantes peuvent être effectuées :
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest <!--NeedCopy-->
-
Supprimez une spécification de version d’image préparée. Par exemple, les opérations suivantes peuvent être effectuées :
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'" Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously <!--NeedCopy-->
-
Supprimez la spécification de version d’image principale. Par exemple, les opérations suivantes peuvent être effectuées :
$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 lorsqu’aucune spécification de version d’image préparée ne lui est associée.
-
Supprimez une version d’image. Par exemple, les opérations suivantes peuvent être effectuées :
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1 <!--NeedCopy-->
-
Supprimez la configuration de la définition d’image dans la connexion hôte spécifiée. Par exemple, les opérations suivantes peuvent être effectuées :
Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx <!--NeedCopy-->
-
Supprimez une définition d’image. Par exemple, les opérations suivantes peuvent être effectuées :
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 unités hôtes :
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 unités hôtes :
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-->
Or,
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-->
Or,
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-->
Or,
Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>] <!--NeedCopy-->
Obtenir la définition d’image, la version d’image, la spécification de version d’image préparée et les détails du schéma de provisioning
-
Obtenez les détails d’une 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 d’une version d’image à l’aide de la commande
Get-ProvImageVersion
. Par exemple :-
Pour répertorier les versions d’image dans une définition d’image :
Get-ProvImageVersion -ImageDefinitionUid <Guid> <!--NeedCopy-->
Or,
Get-ProvImageVersion -ImageDefinitionName <string> <!--NeedCopy-->
-
Pour obtenir le détail d’une version d’image :
Get-ProvImageVersion -ImageVersionUid <Guid> <!--NeedCopy-->
Or,
Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> <!--NeedCopy-->
-
-
Obtenez la spécification d’une 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 d’une version d’image préparée avec succès 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 de la spécification de version d’image préparée :
Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid> <!--NeedCopy-->
-
-
Obtenez les détails d’un 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ée 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-->