Stop-SCVMHost
VMM によって管理されているホストを停止します。
構文
Stop-SCVMHost
[-VMHost] <Host>
[-UseOutOfBandChannel]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Stop-SCVMHost コマンドレットは、Power Off コマンドを発行して、Virtual Machine Manager (VMM) によって管理されているホストを停止します。
ホストを停止できる方法は、帯域内と帯域外 (OOB) の 2 つあります。
既定のパラメーター セットでは、インバンド メソッドを使用してホストをシャットダウンします。
OOB メソッドを使用するには、ホストを OOB 管理用に構成する必要があります。
ホストのベースボード管理コントローラー (BMC) 設定の構成については、「Get-Help Set-SCVMHost -Detailed
」と入力します。
例
例 1: インバンド管理を使用して指定したホストの電源をオフにする
PS C:\> Get-SCVMHost -ComputerName "NewHost01" | Stop-SCVMHost -Confirm
このコマンドは、NewHost01 という名前のホスト オブジェクトを取得し、ホストの電源をオフにします。 このコマンドを実行すると、続行する前にアクションの確認が求められます。
例 2: 帯域外管理を使用して指定したホストの電源をオフにする
PS C:\> Get-SCVMHost -ComputerName "NewHost01" | Stop-SCVMHost -UseOutOfBandChannel -Confirm
このコマンドは、NewHost01 という名前のホスト オブジェクトを取得し、OOB 管理を使用してホストの電源をオフにします。 続行する前に、確認を求めるメッセージが表示されます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseOutOfBandChannel
帯域外管理チャネルを使用して操作を実行する必要があることを示します。 このパラメーターは、コンピューターが応答しない場合にのみ使用してください。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
ホストの各種類の詳細については、Add-SCVMHost コマンドレットを参照してください。
型: | Host |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
Host
このコマンドレットは、Host オブジェクトを返します。