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 les versions d’images à l’aide de :
- Studio
- PowerShell
Utiliser 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 :
- Cliquez sur Catalogues de machines dans le volet 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.
-
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 :
(Azure uniquement) 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 les images dans la galerie.
-
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.
- 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.
Pour afficher l’historique des modifications d’image apportées à un catalogue, procédez comme suit :
- Sélectionnez un catalogue de machines.
- 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 :
- Accédez au nœud Images, sélectionnez une définition d’image et 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 :
- Accédez au nœud Images, sélectionnez une version d’image et 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 et 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 et 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’image 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 :
-
Supprimez le catalogue de machines. Par exemple,
Remove-ProvScheme -ProvisioningScheneName decouplingCatalog <!--NeedCopy--> -
Supprimez la spécification de version d’image préparée partagée. Par exemple,
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest <!--NeedCopy-->
-
- 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-->-
- 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.
-
Supprimez une version d’image. Par exemple,
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1 <!--NeedCopy--> -
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
-
```
-
-
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, 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’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-->
-
-
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 principales 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-->