Freigeben über

Update-AzureVMImage

  • Referenz
Modul:
Azure

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 Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

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.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:VirtualMachineImageDiskConfigSet
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DontShowInGui

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

Typ:SwitchParameter
Position:12
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Eula

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

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IconName

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

Typ:String
Aliase:IconUri
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ImageFamily

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

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ImageName

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Label

Gibt die neue Beschriftung des Bilds an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Language

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

Typ:String
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PrivacyUri

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

Typ:Uri
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

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

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublishedDate

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

Typ:DateTime
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RecommendedVMSize

Gibt die Größe des virtuellen Computers an.

Zulässige Werte für diesen Parameter:

  • Medium
  • Groß
  • Extragroß
  • A5
  • A6
  • A7
Typ:String
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SmallIconName

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

Typ:String
Aliase:SmallIconUri
Position:11
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

OSImageContext