Freigeben über


Stop-SCVirtualMachine

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

Dieses Cmdlet stoppt einen virtuellen Computer wie das Herunterfahren des Betriebssystems auf einem Computer. Wenn Sie den Parameter Force 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 mit dem Namen 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 diese Objekte dann im $VMs Array.

Der zweite Befehl übergibt jedes in $VMs gespeicherte virtuelle Computerobjekt an das aktuelle Cmdlet, das jeden virtuellen Computer stoppt. 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.

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 Namen 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-SaveState

Gibt an, dass dieses Cmdlet den Status 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. 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.