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>]

説明

Stop-SCVirtualMachine コマンドレットは、Virtual Machine Manager (VMM) によって管理されているホストで実行中の 1 つ以上の仮想マシンを停止し、停止状態の仮想マシン オブジェクトを返します。

このコマンドレットは、コンピューター上のオペレーティング システムをシャットダウンするのと同じように、仮想マシンを停止します。 Force パラメーターを指定した場合、このコマンドレットはコンピューターの電源を切るのと同じように仮想マシンを停止します。

停止した仮想マシンを再開するには、Start-SCVirtualMachine コマンドレットを使用します。

例

例 1: 指定した仮想マシンを停止する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Stop-SCVirtualMachine -VM $VM

最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、$VMに格納されている仮想マシンを停止し、停止したオブジェクトに関する情報を表示します。

例 2: 複数の仮想マシンを停止する

PS C:\> $VMs = Get-SCVirtualMachine | where { $_.Name -match "VM" -and $_.Status -eq "Running" }
PS C:\> $VMs | Stop-SCVirtualMachine

最初のコマンドは、名前に文字列 VMM が含まれており、現在の状態が [実行中] であるすべての仮想マシン オブジェクトを取得します。 次に、これらのオブジェクトを $VMs 配列に格納します。

2 番目のコマンドは、$VMsに格納されている各仮想マシン オブジェクトを現在のコマンドレットに渡し、各仮想マシンを停止します。 このコマンドは、停止した仮想マシンに関する情報を表示します。

パラメーター

-DiscardSavedState

このコマンドレットによって、仮想マシンに関連付けられている保存された状態が削除されることを示します。

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

-Force

このコマンドレットは、コンピューターの電源を切るのと同じように仮想マシンを停止することを示します。

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

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーに代わって動作します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、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

このコマンドレットが仮想マシンの状態を保存することを示します。

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

-Shutdown

このコマンドレットが仮想マシンをシャットダウンすることを示します。 このコマンドレットは、オペレーティング システムを使用して仮想マシンを正常にシャットダウンします。

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

このコマンドレットは 、VirtualMachine オブジェクトを返します。

メモ

  • このコマンドレットには、 Get-SCVirtualMachine コマンドレットを使用して取得できる仮想マシン オブジェクトが必要です。