Stop-SCVirtualMachine

Referenz

Modul:: VirtualMachineManager

Beendet virtuelle Computer, die von VMM verwaltet werden.

Syntax

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>]

Beschreibung

Das Cmdlet Stop-SCVirtualMachine beendet eine oder mehrere ausgeführte virtuelle Computer auf Hosts, die von Virtual Machine Manager (VMM) verwaltet werden, und gibt das virtuelle Computerobjekt in einem beendeten Zustand zurück.

Dieses Cmdlet beendet einen virtuellen Computer genauso wie das Herunterfahren des Betriebssystems auf einem Computer. Wenn Sie den Force-Parameter angeben, stoppt dieses Cmdlet einen virtuellen Computer genauso wie das Deaktivieren eines Computers.

Um einen beendeten virtuellen Computer fortzusetzen, verwenden Sie das Cmdlet Start-SCVirtualMachine.

Beispiele

Beispiel 1: Beenden eines angegebenen virtuellen Computers

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

Der erste Befehl ruft das virtuelle Computerobjekt namens VM01 ab und speichert dieses Objekt dann in der $VM Variablen.

Der zweite Befehl beendet den virtuellen Computer, der in $VM gespeichert ist, und zeigt Informationen zum beendeten Objekt an.

Beispiel 2: Beenden mehrerer virtueller Computer

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

Der erste Befehl ruft alle virtuellen Computerobjekte ab, deren Name die Zeichenfolge VMM enthält und dessen aktueller Status ausgeführt wird. Der Befehl speichert dann diese Objekte im $VMs Array.

Der zweite Befehl übergibt jedes in $VMs gespeicherte virtuelle Computerobjekt an das aktuelle Cmdlet, das jeden virtuellen Computer beendet. Der Befehl zeigt Informationen zu den beendeten virtuellen Computern an.

Parameter

-DiscardSavedState

Gibt an, dass dieses Cmdlet den gespeicherten Zustand löscht, der einem virtuellen Computer zugeordnet ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Gibt an, dass dieses Cmdlet einen virtuellen Computer wie das Deaktivieren eines Computers beendet.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-SaveState

Gibt an, dass dieses Cmdlet den Zustand eines virtuellen Computers speichert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Shutdown

Gibt an, dass dieses Cmdlet einen virtuellen Computer heruntergefahren hat. Dieses Cmdlet verwendet das Betriebssystem, um den virtuellen Computer ordnungsgemäß herunterzufahren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Gibt ein Objekt virtueller Maschinen an.

Type:	VM
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Ausgaben

VirtualMachine

Dieses Cmdlet gibt ein VirtualMachine-Objekt zurück.

Hinweise

Dieses Cmdlet erfordert ein virtuelles Computerobjekt, das mithilfe des Cmdlets Get-SCVirtualMachine abgerufen werden kann.