Update-AzureVMImage
Aktualisiert die Bezeichnung eines Betriebssystemimages im Image-Repository.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service 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:
- Weiter
- 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