Delen via

Stop-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Hiermee stopt u virtuele machines die worden beheerd door VMM.

Syntaxis

Stop-SCVirtualMachine
    [-VM] <VM>
    [-Shutdown]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-SaveState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-DiscardSavedState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

De cmdlet Stop-SCVirtualMachine stopt een of meer actieve virtuele machines op hosts die worden beheerd door Virtual Machine Manager (VMM) en retourneert het virtuele-machineobject in een gestopte status.

Met deze cmdlet wordt een virtuele machine gestopt, net zoals het afsluiten van het besturingssysteem op een computer. Als u de parameter Force opgeeft, stopt deze cmdlet een virtuele machine net zoals het uitschakelen van een computer.

Als u een gestopte virtuele machine wilt hervatten, gebruikt u de cmdlet Start-SCVirtualMachine.

Voorbeelden

Voorbeeld 1: Een opgegeven virtuele machine stoppen

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Stop-SCVirtualMachine -VM $VM

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt dat object vervolgens opgeslagen in de $VM variabele.

De tweede opdracht stopt de virtuele machine die is opgeslagen in $VM en geeft informatie weer over het gestopte object.

Voorbeeld 2: Meerdere virtuele machines stoppen

PS C:\> $VMs = Get-SCVirtualMachine | where { $_.Name -match "VM" -and $_.Status -eq "Running" }
PS C:\> $VMs | Stop-SCVirtualMachine

Met de eerste opdracht worden alle virtuele-machineobjecten opgehaald waarvan de naam de tekenreeks VMM bevat en waarvan de huidige status Actief is. Met de opdracht worden deze objecten vervolgens opgeslagen in de $VMs matrix.

Met de tweede opdracht wordt elk object van de virtuele machine dat is opgeslagen in $VMs doorgegeven aan de huidige cmdlet, waardoor elke virtuele machine wordt gestopt. Met de opdracht wordt informatie weergegeven over de gestopte virtuele machines.

Parameters

-DiscardSavedState

Geeft aan dat met deze cmdlet de opgeslagen status wordt verwijderd die is gekoppeld aan een virtuele machine.

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

-Force

Geeft aan dat deze cmdlet een virtuele machine stopt, net zoals het uitschakelen van een computer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
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

-SaveState

Geeft aan dat deze cmdlet de status van een virtuele machine opslaat.

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

-Shutdown

Geeft aan dat deze cmdlet een virtuele machine afsluit. Deze cmdlet gebruikt het besturingssysteem om de virtuele machine probleemloos af te sluiten.

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

Uitvoerwaarden

VirtualMachine

Met deze cmdlet wordt een VirtualMachine-object geretourneerd.

Notities

  • Voor deze cmdlet is een virtuele-machineobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualMachine.