共用方式為

Stop-SCVirtualMachine

  • 參考
模組:
VirtualMachineManager

停止 VMM 管理的虛擬機。

語法

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 會刪除與虛擬機相關聯的已儲存狀態。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Force

指出此 Cmdlet 會停止虛擬機，就像關閉電腦一樣。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-JobVariable

指定追蹤和儲存作業進度的變數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUser

指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUserRole

指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。

類型:UserRole
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SaveState

指出此 Cmdlet 會儲存虛擬機的狀態。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Shutdown

表示此 Cmdlet 會關閉虛擬機。 此 Cmdlet 會使用作業系統正常關閉虛擬機。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VM

指定虛擬機物件。

類型:VM
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸出

VirtualMachine

此 Cmdlet 會傳回 VirtualMachine 物件。

備註

  • 此 Cmdlet 需要虛擬機物件，您可以使用 get-SCVirtualMachine Cmdlet 來擷取此物件。