Remove-SCVirtualHardDisk
Entfernt ein virtuelles Festplattenobjekt aus 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 entfernt ein virtuelles Festplattenobjekt aus einem virtuellen Computer oder einer Vorlage oder aus der Virtual Machine Manager-Bibliothek (VMM). 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) aus dem Bibliotheksserver.
Wenn die virtuelle Festplatte an ein virtuelles Datenträgerlaufwerk auf einem virtuellen Computer oder einer Vorlage angefügt ist (und wenn Sie den Force-Parameter 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 ja antworten, entfernt VMM die Zuordnung zwischen der virtuellen Festplatte und dem Container, dem 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 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 $VHDDer erste Befehl ruft das virtuelle Festplattenobjekt namens VHD01.vhd ab, das auf LibraryServer01 gespeichert ist, und speichert das zurückgegebene Objekt in der $VHD Variablen.
Der zweite Befehl entfernt das in $VHD gespeicherte virtuelle Festplattenobjekt aus der Bibliothek und löscht die entsprechende Datei aus dem Dateisystem auf dem Bibliotheksserver.
Beispiel 2: Entfernen einer virtuellen Festplatte aus 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-SCVirtualHardDiskDer erste Befehl verbindet sich mit VMMServer01.
Der zweite Befehl ruft das virtuelle Computerobjekt namens VM01 ab, ruft alle virtuellen Festplatten auf VM01 ab, deren Name die Zeichenfolge "DataDisk" enthält, und speichert diese virtuellen Festplattenobjekte in einem Array namens $VHD.
Der dritte Befehl entfernt jedes virtuelle Festplattenobjekt, das im $VHD Array vom virtuellen Computer gespeichert ist, und löscht jede entsprechende Datei aus dem Dateisystem auf dem Bibliotheksserver.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDisk
Gibt ein virtuelles Festplattenobjekt an.
| Type: | VirtualHardDisk |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hinweise
- Erfordert ein virtuelles VMM-Festplattenobjekt, das mithilfe des Cmdlets Get-SCVirtualHardDisk abgerufen werden kann.