Update-AzureVMImage

Aktualisiert die Bezeichnung eines Betriebssystemimages im Image-Repository.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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

Beschreibung

Das Cmdlet Update-AzureVMImage aktualisiert die Bezeichnung auf einem Betriebssystemimage im Image-Repository. Es gibt ein Bildobjekt mit Informationen zum aktualisierten Bild zurück.

Beispiele

Beispiel 1: Aktualisieren eines Bilds durch Ändern der Bildbezeichnung

PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"

Mit diesem Befehl wird das Image mit dem Namen "Windows-Server-2008-SP2" aktualisiert, indem die Bildbezeichnung in DoNotUse geändert wird.

Beispiel 2: Abrufen aller Betriebssysteme nach Bezeichnung und Aktualisieren der Bezeichnung

PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"

Dieser Befehl ruft alle Betriebssystemimages mit der Bezeichnung DoNotUse ab und ändert die Bezeichnung in "Aktualisiert".

Parameter

-Description

Gibt die Beschreibung des Betriebssystemimages an.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskConfig

Gibt die Betriebssystemdatenträger- und Datenträgerkonfiguration für das virtuelle Computerimage an, das mithilfe der Cmdlets New-AzureVMImageDiskConfigSet, Set-AzureVMImageOSDiskConfig und Set-AzureVMImageDataDiskConfig erstellt wurde.

Type:VirtualMachineImageDiskConfigSet
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DontShowInGui

Gibt an, dass dieses Cmdlet das Bild in der GUI nicht anzeigt.

Type:SwitchParameter
Position:12
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Eula

Gibt den Endbenutzer-Lizenzvertrag an. Es wird empfohlen, dass der Wert eine URL ist.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IconName

Gibt den Standardsymbolnamen für das Betriebssystem- oder virtuelle Computerimage an.

Type:String
Aliases:IconUri
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageFamily

Gibt einen Wert an, der zum Gruppieren von Betriebssystem- oder virtuellen Computerimages verwendet werden kann.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageName

Gibt den Namen des Bilds an, das im Image-Repository aktualisiert werden soll.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortfahren
  • Ignorieren
  • Fragen
  • SilentlyContinue
  • Beenden
  • Angehalten
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Gibt eine Informationsvariable an.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Label

Gibt die neue Beschriftung des Bilds an.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Language

Gibt die Sprache für das Betriebssystem im virtuellen Computer oder Betriebssystemimage an.

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PrivacyUri

Gibt den URI an, der auf ein Dokument verweist, das die Datenschutzrichtlinie im Zusammenhang mit dem Betriebssystemimage enthält.

Type:Uri
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishedDate

Gibt das Datum an, an dem das Betriebssystemimage dem Image-Repository hinzugefügt wurde.

Type:DateTime
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RecommendedVMSize

Gibt die Größe des virtuellen Computers an.

Zulässige Werte für diesen Parameter:

  • Mittel
  • Groß
  • Extragroß
  • A5
  • A6
  • A7
Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SmallIconName

Gibt den Namen des kleinen Symbols für das Betriebssystem oder das Image des virtuellen Computers an.

Type:String
Aliases:SmallIconUri
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Ausgaben

OSImageContext