Freigeben über


Remove-AzureDataDisk

Entfernt einen Datenträger von einem virtuellen Azure-Computer.

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-AzureDataDisk
      [-LUN] <Int32>
      [-DeleteVHD]
      -VM <IPersistentVM>
      [-Profile <AzureSMProfile>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzureDataDisk entfernt einen Datenträger von einem virtuellen Azure-Computer. Standardmäßig entfernt dieses Cmdlet nicht das Datenträger-BLOB aus dem Speicherkonto.

Beispiele

Beispiel 1: Entfernen eines Datenträgers

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Remove-AzureDataDisk -LUN 0

Mit diesem Befehl wird der virtuelle Computer "VirtualMachine07" im Dienst "ContosoService" mithilfe des Cmdlets "Get-AzureVM " abgerufen. Der Befehl übergibt den virtuellen Computer mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet entfernt den Datenträger mit der LUN 0.

Beispiel 2: Entfernen eines Datenträgers und der virtuellen Festplatte

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Remove-AzureDataDisk -LUN 0 -DeleteVHD | Update-AzureVM

Dieser Befehl ruft den virtuellen Computer "VirtualMachine07" im Dienst "ContosoService" ab. Der Befehl übergibt den virtuellen Computer an das aktuelle Cmdlet. Das aktuelle Cmdlet entfernt den Datenträger mit der LUN 0. Der Befehl enthält den Parameter DeleteVHD . Daher wird auch die zugrunde liegende virtuelle Festplatte gelöscht. Mit dem Befehl wird der virtuelle Computer aktualisiert, um Ihre Änderungen mithilfe des Cmdlets Update-AzureVM widerzuspiegeln.

Parameter

-DeleteVHD

Gibt an, dass dieses Cmdlet den Datenträger und die virtuelle Festplatte (VHD) aus dem BLOB-Speicher entfernt.

Typ:SwitchParameter
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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

-LUN

Gibt die logische Einheitennummer (LUN) für das Datenlaufwerk auf dem virtuellen Computer an. Gültige Werte sind: 0 bis 15.

Typ:Int32
Position:0
Standardwert:None
Erforderlich:True
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

-VM

Gibt das objekt des virtuellen Computers an, das an den Datenträger angefügt ist. Verwenden Sie das Cmdlet "Get-AzureVM ", um ein Objekt eines virtuellen Computers abzurufen.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False