Stop-SCVirtualMachine
停止 VMM 管理的虛擬機器。
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>] Description
Stop-SCVirtualMachine Cmdlet 會在 Virtual Machine Manager 所管理的主機上停止一或多個執行中的虛擬機器， (VMM) ，並傳回處於已停止狀態的虛擬機器物件。
此 Cmdlet 會停止虛擬機器，就像關閉電腦上的作業系統一樣。 如果您指定 Force 參數，此 Cmdlet 會停止虛擬機器，就像關閉電腦一樣。
若要繼續停止的虛擬機器，請使用 Start-SCVirtualMachine Cmdlet。
範例
範例 1：停止指定的虛擬機器
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Stop-SCVirtualMachine -VM $VM第一個命令會取得名為 VM01 的虛擬機器物件，然後將該物件儲存在$VM變數中。
第二個命令會停止儲存在 $VM 中的虛擬機器，並顯示已停止物件的相關資訊。
範例 2：停止多部虛擬機器
PS C:\> $VMs = Get-SCVirtualMachine | where { $_.Name -match "VM" -and $_.Status -eq "Running" }
PS C:\> $VMs | Stop-SCVirtualMachine第一個命令會取得名稱包含 VMM 字串且目前狀態為 [正在執行] 的所有虛擬機器物件。 命令接著會將這些物件儲存在$VMs陣列中。
第二個命令會將儲存在 $VMs 中的每個虛擬機器物件傳遞至目前的 Cmdlet，這會停止每個虛擬機器。 此命令會顯示已停止虛擬機器的相關資訊。
參數
-DiscardSavedState
指出此 Cmdlet 會刪除與虛擬機器相關聯的已儲存狀態。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
表示此 Cmdlet 會停止虛擬機器，就像關閉電腦一樣。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定追蹤和儲存作業進度的變數。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定使用者名稱。 此 Cmdlet 代表此參數指定的使用者運作。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 此 Cmdlet 代表此參數所指定的使用者角色運作。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定觸發此動作之 PRO 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SaveState
指出此 Cmdlet 會儲存虛擬機器的狀態。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Shutdown
指出此 Cmdlet 會關閉虛擬機器。 此 Cmdlet 會使用作業系統以正常方式關閉虛擬機器。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定虛擬機器物件。
| Type: | VM |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
VirtualMachine
此 Cmdlet 會傳回 VirtualMachine 物件。
備註
- 此 Cmdlet 需要虛擬機器物件，可以使用 Get-SCVirtualMachine Cmdlet 來擷取。