Delen via

Remove-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een virtuele-machineobject uit VMM.

Syntaxis

Remove-SCVirtualMachine
      [-VM] <VM>
      [-SkipFileRemoval]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Met de cmdlet Remove-SCVirtualMachine verwijdert u een virtuele-machineobject dat is geïmplementeerd op een host of is opgeslagen op een VMM-bibliotheekserver (Virtual Machine Manager).

Met deze cmdlet verwijdert u de record van de virtuele machine uit de VMM-database, verwijdert u alle bestanden die zijn gekoppeld aan de virtuele machine en verwijdert u de virtuele machine van de host waarop deze is geïmplementeerd of van de bibliotheekserver waarop deze is opgeslagen.

Als een map op een host is gemaakt voor deze virtuele machine door VMM, in plaats van door Hyper-V of VMware, en als die map geen andere virtuele machines of andere gegevens bevat, kunt u het bestandssysteem gebruiken om de map te verwijderen nadat u de virtuele machine hebt verwijderd.

Als u de parameter Force opgeeft, verwijdert deze cmdlet alleen de virtuele machine uit de VMM-database. De virtuele machine zelf wordt niet verwijderd.

Deze cmdlet retourneert het object bij succes met een waarde van $True voor de eigenschap MarkedForDeletion. Als dit mislukt, retourneert de cmdlet een foutbericht.

Voorbeelden

Voorbeeld 1: Een specifieke virtuele machine verwijderen die op een host is geïmplementeerd

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald dat is geïmplementeerd op VMHost01 en slaat u vervolgens het object van de virtuele machine op in de variabele $VM.

Met de tweede opdracht wordt het object verwijderd dat is opgeslagen in $VM en worden de bijbehorende bestanden van de virtuele machine verwijderd uit het bestandssysteem op de host.

Voorbeeld 2: Alle virtuele machines verwijderen met namen die een specifieke tekenreeks bevatten

PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine

Met de eerste opdracht worden alle virtuele-machineobjecten opgehaald die zijn geïmplementeerd op een host waarvan de naam de tekenreeks-VM0 bevat en slaat u deze virtuele-machineobjecten vervolgens op in de matrix met de naam $VMs.

Met de tweede opdracht verwijdert u elk virtuele-machineobject in de $VMs matrix en verwijdert u de bijbehorende bestanden van de virtuele machine uit het bestandssysteem op elke host.

Voorbeeld 3: Een specifieke virtuele machine verwijderen die is opgeslagen op een VMM-bibliotheekserver

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM

Met de eerste opdracht wordt het object opgehaald dat de virtuele machine met de naam VM03 vertegenwoordigt en slaat het virtuele-machineobject vervolgens op in $VM. In dit voorbeeld bestaat er slechts één virtuele machine met de naam VM03.

Met de tweede opdracht verwijdert u het object dat VM03 uit de bibliotheek vertegenwoordigt en verwijdert u de bijbehorende bestanden van de virtuele machine uit het bestandssysteem op de bibliotheekserver.

Voorbeeld 4: Meerdere opgeslagen virtuele machines verwijderen uit de VMM-bibliotheek

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm

Met de eerste opdracht worden alle virtuele-machineobjecten opgehaald waarvan de namen de tekenreeks-VM0 bevatten en die zijn opgeslagen op LibraryServer01. Met de opdracht worden vervolgens de virtuele-machineobjecten opgeslagen in de matrix met de naam $VMs.

Met de tweede opdracht wordt elk virtuele-machineobject dat is opgeslagen in $VMs doorgegeven aan de huidige cmdlet, waarmee elk object uit de bibliotheek wordt verwijderd en de bijbehorende bestanden van de virtuele machine worden verwijderd uit het bestandssysteem op de bibliotheekserver. De Bevestig parameter vraagt u om te bevestigen of u elk van deze virtuele machines wilt verwijderen.

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

Geeft aan dat met deze cmdlet alleen de virtuele machine uit de VMM-database wordt verwijderd. De virtuele machine zelf wordt niet verwijderd.

Notitie

Voor virtuele machines die zijn geïmplementeerd met behulp van servicesjablonen of VMRole, wordt deze parameter genegeerd en wordt de werkelijke virtuele machine ook verwijderd.

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

-JobVariable

Hiermee geeft u een variabele op waarin de voortgang van de taak wordt bijgehouden en opgeslagen.

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

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

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

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
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

-SkipFileRemoval

Geeft aan dat met deze cmdlet gerelateerde bestanden van virtuele machines niet rechtstreeks worden verwijderd. Als u deze parameter opgeeft, wordt er geen poging gedaan om bestanden rechtstreeks te verwijderen.

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

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
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

Voor deze cmdlet is een VMM-vm-object vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualMachine.