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