Update-AzureVMImage
Met à jour l’étiquette d’une image de système d’exploitation dans le référentiel d’images.
Notes
Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.
Syntax
Update-AzureVMImage
[-ImageName] <String>
[-Label] <String>
[[-Eula] <String>]
[[-Description] <String>]
[[-ImageFamily] <String>]
[[-PublishedDate] <DateTime>]
[[-PrivacyUri] <Uri>]
[[-RecommendedVMSize] <String>]
[[-DiskConfig] <VirtualMachineImageDiskConfigSet>]
[[-Language] <String>]
[[-IconName] <String>]
[[-SmallIconName] <String>]
[-DontShowInGui]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
L’applet de commande Update-AzureVMImage met à jour l’étiquette sur une image du système d’exploitation dans le référentiel d’images. Elle retourne un objet image avec des informations sur l’image mise à jour.
Exemples
Exemple 1 : Mettre à jour une image en modifiant l’étiquette d’image
PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"
Cette commande met à jour l’image nommée Windows-Server-2008-SP2 en modifiant l’étiquette d’image en DoNotUse.
Exemple 2 : Obtenir tous les systèmes d’exploitation par étiquette, puis mettre à jour l’étiquette
PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"
Cette commande obtient toutes les images du système d’exploitation étiquetées DoNotUse et remplace l’étiquette par Mise à jour.
Paramètres
-Description
Spécifie la description de l’image du système d’exploitation.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskConfig
Spécifie la configuration du disque du système d’exploitation et du disque de données pour l’image de machine virtuelle créée à l’aide des applets de commande New-AzureVMImageDiskConfig, Set-AzureVMImageOSDiskConfig et Set-AzureVMImageDataDiskConfig .
Type: | VirtualMachineImageDiskConfigSet |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DontShowInGui
Indique que cette applet de commande n’affiche pas l’image dans l’interface utilisateur graphique.
Type: | SwitchParameter |
Position: | 12 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Eula
Spécifie le contrat de licence utilisateur final. Nous recommandons que la valeur soit une URL.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IconName
Spécifie le nom de l’icône standard pour le système d’exploitation ou l’image de machine virtuelle.
Type: | String |
Aliases: | IconUri |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageFamily
Spécifie une valeur qui peut être utilisée pour regrouper des images de système d’exploitation ou de machine virtuelle.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageName
Spécifie le nom de l’image à mettre à jour dans le référentiel d’images.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Spécifie la façon dont cette applet de commande répond à un événement d’information.
Les valeurs valides pour ce paramètre sont :
- Continuer
- Ignorer
- Renseignez-vous
- SilentlyContinue
- Arrêter
- Suspendre
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Spécifie une variable d’informations.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Spécifie la nouvelle étiquette de l’image.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Language
Spécifie la langue du système d’exploitation sur la machine virtuelle ou l’image du système d’exploitation.
Type: | String |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivacyUri
Spécifie l’URI qui pointe vers un document qui contient la stratégie de confidentialité liée à l’image du système d’exploitation.
Type: | Uri |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublishedDate
Spécifie la date à laquelle l’image du système d’exploitation a été ajoutée au référentiel d’images.
Type: | DateTime |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RecommendedVMSize
Spécifie la taille de la machine virtuelle.
Les valeurs valides pour ce paramètre sont :
- Moyenne
- Grande
- Très grande
- A5
- A6
- A7
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SmallIconName
Spécifie le nom de la petite icône pour le système d’exploitation ou l’image de machine virtuelle.
Type: | String |
Aliases: | SmallIconUri |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Sorties
OSImageContext