Freigeben über

Remove-AzureVMImage

  • Referenz
Modul:
Azure

Entfernt ein Betriebssystemimage aus dem 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

Remove-AzureVMImage
      [-ImageName] <String>
      [-DeleteVHD]
      [-Profile <AzureSMProfile>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzureVMImage entfernt ein Betriebssystemimage aus dem Image-Repository. Standardmäßig löscht dieses Cmdlet nicht den zugeordneten physischen Bild-BLOB aus dem Speicherkonto. Verwenden Sie zum Löschen der zugeordneten virtuellen Festplatte (VHD) den Parameter DeleteVHD .

Beispiele

Beispiel 1: Entfernen eines Bilds aus dem Image-Repository

PS C:\> Remove-AzureVMImage -ImageName "Image001"

Mit diesem Befehl wird das Bild "Image001" aus dem Image-Repository entfernt.

Beispiel 2: Entfernen eines Bilds aus dem Image-Repository und auch der VHD

PS C:\> Remove-AzureVMImage -ImageName " Image001" -DeleteVHD

Mit diesem Befehl wird das Bild "Image001" aus dem Image-Repository entfernt und auch das physische VHD-Bild aus dem Speicherkonto gelöscht.

Beispiel 3: Festlegen eines Abonnementkontexts und Entfernen aller Bilder

PS C:\> $SubsId = &lt;MySubscriptionID&gt;
PS C:\> $Cert = Get-AzureCertificate cert:\LocalMachine\MY\&lt;CertificateThumbprint&gt;
PS C:\> Get-AzureVMImage `
| Where-Object {$_.Label -match "Beta" }`
| Foreach-Object {Remove-AzureVMImage -ImageName $_.name }

Dieser Befehl legt den Abonnementkontext fest und entfernt dann alle Bilder aus dem Image-Repository, dessen Bezeichnung den Namen Beta enthält.

Parameter

-DeleteVHD

Gibt an, dass dieses Cmdlet den physischen VHD-Bild-BLOB aus dem Speicherkonto löscht.

Typ:SwitchParameter
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImageName

Gibt das Betriebssystem- oder virtuelle Computerimage an, das aus dem Image-Repository entfernt 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

-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