Remove-AzVMDataDisk

  • Referenz
Modul:
Az.Compute

Entfernt einen Datenträger von einem virtuellen Computer.

Syntax

Remove-AzVMDataDisk
      [-VM] <PSVirtualMachine>
      [[-DataDiskNames] <String[]>]
      [-ForceDetach]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzVMDataDisk entfernt einen Datenträger von einem virtuellen Computer.

Beispiele

Beispiel 1: Entfernen eines Datenträgers von einem virtuellen Computer

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" 
Remove-AzVMDataDisk -VM $VirtualMachine -Name "Disk3"
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Der erste Befehl ruft den virtuellen Computer mit dem Namen VirtualMachine07 mithilfe des Cmdlets "Get-AzVM " ab. Der Befehl speichert den virtuellen Computer in der Variablen $VirtualMachine . Mit dem zweiten Befehl wird der Datenträger "Disk3" aus dem virtuellen Computer entfernt, der in $VirtualMachine gespeichert ist. Der letzte Befehl aktualisiert den Zustand des virtuellen Computers, der in $VirtualMachine in ResourceGroup11 gespeichert ist.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataDiskNames

Gibt die Namen eines oder mehrerer Datenträger an, die dieses Cmdlet entfernt.

Typ:String[]
Aliase:Name
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceDetach

Legt die Eigenschaft "detachOption" auf "ForceDetach" für die bereitgestellten Datenträger fest. Gilt nur für verwaltete Datenträger.

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

-VM

Gibt das objekt des lokalen virtuellen Computers an, aus dem ein Datenträger entfernt werden soll. Verwenden Sie das Cmdlet "Get-AzVM", um ein Objekt eines virtuellen Computers abzurufen.

Typ:PSVirtualMachine
Aliase:VMProfile
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSVirtualMachine

Ausgaben

PSVirtualMachine