Remove-SCVirtualHardDisk

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

Mit dem Cmdlet Remove-SCVirtualHardDisk wird ein virtuelles Festplattenobjekt von einem virtuellen Computer oder einer Vorlage oder aus der Virtual Machine Manager (VMM)-Bibliothek entfernt. Remove-VirtualHardDisk löscht auch die entsprechende virtuelle Festplattendatei (eine Windows-basierte VHD-Datei, eine Citrix XenServer-basierte VHD-Datei oder eine VMware-basierte VMDK-Datei) vom Bibliothekserver.

Wenn die virtuelle Festplatte an ein virtuelles Laufwerk auf einer virtuellen Maschine oder Vorlage angefügt ist (und 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 mit 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 mit Nein antworten, wird der Vorgang abgebrochen.

Dieses Cmdlet gibt das Objekt bei Erfolg zurück (wobei die Eigenschaft MarkedForDeletion auf True festgelegt ist) oder gibt eine Fehlermeldung zurück, wenn ein Fehler auftritt.

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

Mit dem ersten Befehl wird das virtuelle Festplattenobjekt mit dem Namen VHD01.vhd abgerufen, das auf LibraryServer01 gespeichert ist, und das zurückgegebene Objekt in der Variablen $VHD gespeichert.

Der zweite Befehl entfernt das in $VHD gespeicherte virtuelle Festplattenobjekt aus der Bibliothek und löscht die entsprechende Datei aus dem Dateisystem auf dem Library-Server.

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 her.

Der zweite Befehl ruft das VM-Objekt mit dem Namen 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 mit dem Namen $VHD.

Mit dem dritten Befehl werden alle im $VHD Array gespeicherten virtuellen Festplattenobjekte aus der virtuellen Maschine entfernt und alle entsprechenden Dateien aus dem Dateisystem auf dem Bibliothekserver gelöscht.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

• Erfordert ein virtuelles VMM-Festplattenobjekt, das mit dem Cmdlet Get-SCVirtualHardDisk abgerufen werden kann.