Disable-SCVMHost
仮想マシン ホストをメンテナンス モードにします。
構文
Disable-SCVMHost
[-VMHost] <Host>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Disable-SCVMHost
[-VMHost] <Host>
[-MoveWithinCluster]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Disable-SCVMHost コマンドレットは、Virtual Machine Manager (VMM) によって管理されている仮想マシン ホストをメンテナンス モードにして、セキュリティ更新プログラムの適用やハードウェアの交換などのメンテナンス タスクをホストで実行できるようにします。
Disable-SCVMHost コマンドレットを使用して、個々の Hyper-V ホスト、VMware ESX ホスト、または Citrix XenServer ホストをメンテナンス モードにすることができます。 Disable-SCVMHost を使用して、クラスター化されたホストをメンテナンス モードにすることもできます。
ホストをサービスに戻すには、Enable-SCVMHost コマンドレットを使用します。
Hyper-V ホストをメンテナンス モードにするには
ホストがライブ マイグレーションをサポートするクラスターに属している場合は、次のいずれかの方法を選択できます。
方法 1: 高可用性仮想マシンを移行し、他の仮想マシンを保存します。
方法 2: すべての仮想マシンを保存します。
Disable-SCVMHost
ホストがクラスターに属していない場合、またはライブ マイグレーションをサポートしていないクラスターに属している場合は、Disable-SCVMHost を使用すると、実行中のすべての仮想マシンが保存された状態になり、ユーザーはサービスを失います。 次に、ホストをメンテナンス モードにします。
DISABLE-SCVMHost を VMWare ESX ホストと
Disable-SCVMHostを使用して ESX ホストをメンテナンス モードにすると、VMM は、そのホストを管理する VMware cCenter Server にメンテナンス モードに入る要求を送信します。 vCenter Server は、ESX ホストをメンテナンス モードにします。
注: ESX サーバー ホスト上の仮想マシンのシステム動作は、vCenter Server の構成によって決まります。 たとえば、VMware 分散リソース スケジューラが構成されていない場合は、ホスト上のすべての仮想マシンを手動でシャットダウンする必要がある場合があります。 または、ESX Server ホストをメンテナンス モードに正常に配置するために、仮想マシンを別のホストに移動する必要がある場合があります。
XenServer ホストをメンテナンス モードにするには
ホストがライブ マイグレーションをサポートするクラスターに属している場合は、次のいずれかの方法を選択できます。
方法 1: 高可用性仮想マシンを移行し、他の仮想マシンを保存します。
方法 2: すべての仮想マシンを保存します。 Disable-VMHost は、実行中のすべての仮想マシンを保存済みの状態にして、ユーザーがサービスを失う原因となります。 次に、ホストをメンテナンス モードにします。
ホストがクラスターに属していない場合、またはライブ マイグレーションをサポートしていないクラスターに属している場合は、Disable-VMHost を使用すると、実行中のすべての仮想マシンが保存された状態になり、ユーザーはサービスを失います。 次に、ホストをメンテナンス モードにします。
メンテナンス モードでのホストの動作
ホストをメンテナンス モードにすると、次のアクションが影響を受けます。
- ホスト上に仮想マシンを作成することはできません。
- 仮想マシンをホストに移行することはできません。
- ホストは、仮想マシンの配置中に実行されるホスト評価の計算から除外されます。
- ホストの状態は更新されません。
ただし、次のアクションを実行できます。
- ホストが使用可能であり、そのエージェントが適切な状態であることを確認する場合は、VMM からホストを削除します。
- ホスト上の仮想マシンを起動または停止します。
- ホストのプロパティを変更します。
- 仮想マシンをホストから別のホストに移行します。
例
例 1: 指定したホストをメンテナンス モードにして、実行中のすべての仮想マシンを保存する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Disable-SCVMHost -VMHost $VMHost
最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、$VMHost変数にオブジェクトを格納します。
2 番目のコマンドでは、$VMHostに格納されているホストにデプロイされているすべての実行中の仮想マシンが保存された状態に配置されます。 次に、ホストの状態を "メンテナンス モード中" に設定します。
例 2: ライブ マイグレーションを使用して、実行中のすべての高可用性仮想マシンをメンテナンス モードのクラスター ノードに移行する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> Disable-SCVMHost -VMHost $VMHost -MoveWithinCluster
最初のコマンドは、VMHost02 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドでは、ライブ マイグレーションを使用して、$VMHostに格納されているホスト上で実行中のすべての高可用性仮想マシンをクラスター内の別のノードに移行します。 実行中の他の仮想マシンを保存済み状態にしてから、ホスト状態プロパティの値を "メンテナンス モード中" に設定します。
パラメーター
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MoveWithinCluster
ホスト クラスターのメンバーであるホストに現在デプロイされているすべての仮想マシンが、そのホストがメンテナンス モードに設定されている場合、同じホスト クラスター内の別のホストに移行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
ホストの各種類の詳細については、Add-SCVMHost コマンドレットを参照してください。
型: | Host |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
Host
このコマンドレットは、Host オブジェクトを返します。
メモ
- 一時的なメンテナンス モードにしたホストは、メンテナンス ホストとして指定したホストとは異なります。 メンテナンス ホストは、次のような仮想マシンのメンテナンス タスク専用のホストです。
- 格納されている仮想マシンとテンプレートに修正プログラムを適用する。
- 仮想マシンを運用環境に移動する前に、ステージングスクリプトを実行した仮想マシンの作成。