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 von einem virtuellen Computer oder einer Vorlage oder aus der VMM-Bibliothek (Virtual Machine Manager). Remove-VirtualHardDisk löscht auch die entsprechende virtuelle Festplattendatei (eine windowsbasierte VHD-Datei, eine Citrix XenServer-basierte VHD-Datei oder eine VMware-basierte VMDK-Datei) vom Bibliotheksserver.
Wenn die virtuelle Festplatte an ein virtuelles Datenträgerlaufwerk 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 "Ja" beantworten, entfernt VMM die Zuordnung zwischen der virtuellen Festplatte und dem Container, an den sie angefügt ist, und löscht das virtuelle Festplattenobjekt von VMM.
Wenn Sie antworten Nein, wird der Vorgang abgebrochen.
Dieses Cmdlet gibt das Objekt nach Erfolg zurück (mit der Eigenschaft MarkedForDeletion auf True festgelegt) oder eine Fehlermeldung beim Fehler 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 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 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 virtuelle Computerobjekt mit dem Namen 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
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.