Stop-SCVirtualMachine
Beendet virtuelle Maschinen, die von VMM verwaltet werden.
Syntax
SingleVM (Standardwert)
Stop-SCVirtualMachine
[-VM] <VM>
[-Shutdown]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
CorrespondsToVMM2008SaveStateVM
Stop-SCVirtualMachine
[-VM] <VM>
[-SaveState]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
CorrespondsToVMM2008DiscardSavedStateVM
Stop-SCVirtualMachine
[-VM] <VM>
[-DiscardSavedState]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
CorrespondsToVMM2008StopVM
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 Maschinen auf Hosts, die von Virtual Machine Manager (VMM) verwaltet werden, und gibt das Objekt des virtuellen Computers in einem gestoppten Zustand zurück.
Dieses Cmdlet stoppt einen virtuellen Computer genau wie das Herunterfahren des Betriebssystems auf einem Computer. Wenn Sie den Force-Parameter angeben, beendet dieses Cmdlet einen virtuellen Computer genau wie das Ausschalten eines Computers.
Um einen angehaltenen 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 VM-Objekt mit dem Namen VM01 ab und speichert dieses Objekt dann in der Variablen $VM.
Der zweite Befehl stoppt die in $VM gespeicherte virtuelle Maschine und zeigt Informationen über das gestoppte 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
Mit dem ersten Befehl werden alle VM-Objekte abgerufen, deren Name die Zeichenfolge VMM enthält und deren aktueller Status Wird ausgeführt lautet. Der Befehl speichert diese Objekte dann im $VMs Array.
Der zweite Befehl übergibt jedes in $VMs gespeicherte VM-Objekt an das aktuelle Cmdlet, das jeden virtuellen Computer beendet. Der Befehl zeigt Informationen zu den gestoppten virtuellen Maschinen an.
Parameter
-DiscardSavedState
Gibt an, dass dieses Cmdlet den gespeicherten Zustand löscht, der einem virtuellen Computer zugeordnet ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
CorrespondsToVMM2008DiscardSavedStateVM
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Gibt an, dass dieses Cmdlet einen virtuellen Computer genau wie das Ausschalten eines Computers beendet.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
CorrespondsToVMM2008StopVM
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-JobVariable
Gibt eine Variable an, in der der Auftragsfortschritt verfolgt und gespeichert wird.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | UserRole |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SaveState
Gibt an, dass dieses Cmdlet den Status eines virtuellen Computers speichert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
CorrespondsToVMM2008SaveStateVM
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Shutdown
Gibt an, dass dieses Cmdlet einen virtuellen Computer herunterfährt. Dieses Cmdlet verwendet das Betriebssystem, um den virtuellen Computer ordnungsgemäß herunterzufahren.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SingleVM
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VM
Gibt ein Objekt eines virtuellen Computers an.
Parametereigenschaften
| Typ: | VM |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
VirtualMachine
Dieses Cmdlet gibt ein VirtualMachine-Objekt zurück.
Hinweise
- Für dieses Cmdlet ist ein VM-Objekt erforderlich, das mit dem Cmdlet Get-SCVirtualMachine abgerufen werden kann.