Freigeben über

Remove-SCVirtualHardDisk

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein virtuelles Festplattenobjekt von einem virtuellen Computer oder einer Vorlage oder aus der VMM-Bibliothek.

Syntax

Remove-SCVirtualHardDisk
      [-VirtualHardDisk] <VirtualHardDisk>
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCVirtualHardDisk Cmdlet entfernt ein Objekt einer virtuellen Festplatte von einem virtuellen Computer oder einer Vorlage oder aus der VMM-Bibliothek (Virtual Machine Manager). Remove-VirtualHardDisk auch die entsprechende virtuelle Festplatte (eine Windows-basierte VHD-Datei, eine Citrix XenServer-basierte VHD-Datei oder eine VMware-basierte VMDK-Datei) vom Bibliotheksserver löscht.

Wenn die virtuelle Festplatte an ein virtuelles Festplattenlaufwerk auf einem virtuellen Computer oder einer Vorlage angefügt ist (und wenn Sie den Parameter Force nicht verwenden), listet VMM den Container auf, der die virtuelle Festplatte enthält, und fordert Sie auf, zu bestätigen, dass Sie die virtuelle Festplatte entfernen möchten:

  • Wenn Sie auf "Ja" antworten, entfernt VMM die Zuordnung zwischen der virtuellen Festplatte und dem Container, an den sie angefügt ist, und löscht dann das virtuelle Festplattenobjekt aus VMM.

  • Wenn Sie "Nein" antworten, wird der Vorgang abgebrochen.

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf "True" festgelegt) zurück oder gibt bei Einem Fehler eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen eines virtuellen Festplattenobjekts aus der Bibliothek

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

Der erste Befehl ruft das virtuelle Festplattenobjekt mit dem Namen VHD01.vhd ab, das auf LibraryServer01 gespeichert ist, und speichert das zurückgegebene Objekt in der $VHD Variablen.

Der zweite Befehl entfernt das virtuelle Festplattenobjekt, das in $VHD gespeichert ist, aus der Bibliothek und löscht die entsprechende Datei aus dem Dateisystem auf dem Bibliotheksserver.

Beispiel 2: Entfernen einer virtuellen Festplatte von einem virtuellen Computer

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

Der erste Befehl stellt eine Verbindung mit VMMServer01 bereit.

Der zweite Befehl ruft das Objekt des virtuellen Computers namens VM01 ab, ruft alle virtuellen Festplatten auf VM01 ab, deren Name die Zeichenfolge "DataDisk" enthält, und speichert diese virtuellen Festplattenobjekte dann in einem Array namens $VHD.

Der dritte Befehl entfernt jedes virtuelle Festplattenobjekt, das im $VHD Array gespeichert ist, vom virtuellen Computer und löscht jede entsprechende Datei aus dem Dateisystem auf dem Bibliotheksserver.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

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

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

Typ:VirtualHardDisk
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, 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

Hinweise

  • Erfordert ein virtuelles VMM-Festplattenobjekt, das mithilfe des Cmdlets Get-SCVirtualHardDisk abgerufen werden kann.