Freigeben über

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 Cmdlet stoppt mindestens einen ausgeführten virtuellen Computer auf Hosts, die vom Virtual Machine Manager (VMM) verwaltet werden, und gibt das Objekt des virtuellen Computers in einem angehaltenen Zustand zurück.

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

Verwenden Sie das Cmdlet Start-SCVirtualMachine, um einen angehaltenen virtuellen Computer fortzusetzen.

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 Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert dieses Objekt dann in der $VM Variablen.

Der zweite Befehl stoppt den virtuellen Computer, der in $VM gespeichert ist, und zeigt Informationen zum angehaltenen 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 Objekte des virtuellen Computers ab, deren Name die Zeichenfolge VMM enthält und dessen aktueller Status ausgeführt wird. Anschließend speichert der Befehl diese Objekte im $VMs Array.

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

Parameter

-DiscardSavedState

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SaveState

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Shutdown

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:VM
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualMachine

Dieses Cmdlet gibt ein VirtualMachine-Objekt zurück.

Hinweise

  • Für dieses Cmdlet ist ein Objekt des virtuellen Computers erforderlich, das mithilfe des cmdlets Get-SCVirtualMachine abgerufen werden kann.