Delen via

Remove-SCVirtualHardDisk

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een virtueel hardeschijfobject uit een virtuele machine of sjabloon of uit de VMM-bibliotheek.

Syntaxis

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

Description

Met de cmdlet Remove-SCVirtualHardDisk verwijdert u een virtuele hardeschijfobject uit een virtuele machine of sjabloon of uit de VMM-bibliotheek (Virtual Machine Manager). Remove-VirtualHardDisk verwijdert ook het bijbehorende virtuele hardeschijfbestand (een VHD-bestand op basis van Windows, een VHD-bestand op basis van Citrix XenServer of een VMware-vmdk-bestand) van de bibliotheekserver.

Als de virtuele harde schijf is gekoppeld aan een virtuele schijf op een virtuele machine of sjabloon (en als u de parameter Force niet gebruikt), vermeldt VMM de container die de virtuele harde schijf bevat en vraagt u om te bevestigen dat u de virtuele harde schijf wilt verwijderen:

  • Als u Ja beantwoordt, verwijdert VMM de koppeling tussen de virtuele harde schijf en de container waaraan deze is gekoppeld en verwijdert u vervolgens het virtuele hardeschijfobject uit VMM.

  • Als u Nee beantwoordt, wordt de bewerking geannuleerd.

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op True) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een virtueel hardeschijfobject uit de bibliotheek verwijderen

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

Met de eerste opdracht wordt het virtuele hardeschijfobject met de naam VHD01.vhd opgeslagen op LibraryServer01 en wordt het geretourneerde object opgeslagen in de $VHD variabele.

Met de tweede opdracht verwijdert u het virtuele hardeschijfobject dat is opgeslagen in $VHD uit de bibliotheek en verwijdert u het bijbehorende bestand uit het bestandssysteem op de bibliotheekserver.

Voorbeeld 2: Een virtuele harde schijf van een virtuele machine verwijderen

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

De eerste opdracht maakt verbinding met VMMServer01.

Met de tweede opdracht wordt het virtuele-machineobject MET de naam VM01 opgehaald, worden alle virtuele harde schijven op VM01 opgehaald waarvan de naam de tekenreeks 'DataDisk' bevat en slaat u deze virtuele hardeschijfobjecten vervolgens op in een matrix met de naam $VHD.

Met de derde opdracht verwijdert u elk virtuele hardeschijfobject dat is opgeslagen in de $VHD matrix van de virtuele machine en verwijdert u elk bijbehorend bestand uit het bestandssysteem op de bibliotheekserver.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualHardDisk

Hiermee geeft u een virtuele harde schijf-object.

Type:VirtualHardDisk
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Notities

  • Hiervoor is een VMM-object voor virtuele harde schijven vereist, dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualHardDisk.