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