3.7.6 仮想サーバの停止
機能
このサービステンプレートは,Hyper-V環境の複数の仮想サーバのOSを強制的にシャットダウンします。
このサービステンプレートが前提とするサーバを次に示します。
・Hyper-Vサーバ
Hyper-Vがインストールされているサーバです。
・仮想サーバ
Hyper-Vによって管理されている仮想サーバです。
処理の概要を次に示します。
(1) 仮想サーバの状態を取得します。詳細については,本製品マニュアルの「Hyper-Vが管理している仮想サーバの状態一覧」を参照してください。
(2) 仮想サーバが起動完了の状態である場合に,仮想サーバのOSをシャットダウンします。状態が停止完了の場合は,仮想サーバのOSをシャットダウンする処理をスキップし,状態が起動完了と停止完了以外の場合は,該当する仮想サーバの処理がエラーとなります。
上記の処理を,指定された仮想サーバ群に対して並列に実行します。
仮想サーバのOSをシャットダウンする際には,hyperv.checkVmStateDisabledIntervalプロパティに指定した秒数待ち合わせ,仮想サーバの状態を確認する動作を,hyperv.checkVmStateDisabledCountプロパティに指定した回数繰り返します。各プロパティの値は,利用している環境に合わせて調整してください。
前提条件
【システム内前提製品】/【サービステンプレート実行システム内前提製品】/【サービステンプレート実行システム内前提製品の稼働OS】の最新のサポート状況については,リリースノートを参照してください。
【システム内前提製品】
JP1/Automatic Operation 11-10以降
【サービステンプレート実行システム内前提製品】
(1)Hyper-Vサーバの前提製品
・Windows Server 2008 R2 Hyper-V
【サービステンプレート実行システム内前提製品の稼働OS】
(1)Hyper-Vサーバの前提OS
・Windows Server 2008 R2 Standard/Enterprise/Datacenter
ただし,Server Coreインストール環境は除く。
(2)仮想サーバの前提OS
・Windows Server 2008 R2 Standard/Enterprise/Datacenter
ただし,Server Coreインストール環境は除く。
【サービステンプレート実行システム内前提製品の使用条件】
(1)仮想サーバ名はHyper-Vサーバ内で一意であること。
(2)対象の仮想サーバにおけるHyper-V 統合サービスの次のサービスが有効なこと。
・オペレーティングシステムのシャットダウン
注意事項
(1)このサービスは指定した仮想サーバのOSを強制的にシャットダウンします。このサービスを実行した場合,仮想サーバで編集中のファイルデータは保存されません。
バージョン
02.12.00
タグ
Control VM,Hyper-V 2008
プロパティ一覧
プロパティに設定されているプロパティグループの一覧を次に示します。
プロパティグループ |
説明 |
初期表示 |
---|---|---|
仮想システム環境情報 |
Hyper-Vの情報を指定してください。 |
表示されます。 |
仮想サーバ情報 |
停止する仮想サーバの情報を指定してください。 |
表示されます。 |
実行時オプション |
仮想サーバを停止する際の状態確認に関するプロパティです。必要に応じて変更してください。 |
表示されません。 |
[サービス設定]画面に表示されるプロパティの一覧を次に示します。
- (凡例)
-
○:プロパティの指定は必須です。
△:プロパティの指定は省略可能です。ただし,ほかのプロパティの指定内容によっては,指定が必須になります。各プロパティの「説明」を確認してください。
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
必須区分 |
プロパティグループ |
---|---|---|---|---|---|---|
hyperv.targetHost |
Hyper-Vサーバのホスト名 |
Hyper-Vサーバのホスト名またはIPアドレスを指定します。IPv6アドレスには対応していません。 |
入力 |
無効 |
○ |
仮想システム環境情報 |
hyperv.checkVmStateDisabledCount |
仮想サーバの状態(停止完了)の確認回数 |
仮想サーバの停止が完了したか確認する際の確認回数を指定します。仮想サーバの状態(停止完了)の確認間隔と組み合わせて最大待ち時間となります。 |
入力 |
無効 |
○ |
実行時オプション |
hyperv.checkVmStateDisabledInterval |
仮想サーバの状態(停止完了)の確認間隔 |
仮想サーバの停止が完了したか確認する際の確認間隔を秒単位で指定します。 |
入力 |
無効 |
○ |
実行時オプション |
hyperv.checkJobShutdownCount |
ジョブ監視回数(InitiateShutdownメソッド) |
Hyper-Vに要求した処理を監視する,ジョブ監視回数(InitiateShutdownメソッド)調整用のプロパティです。変更の必要はありません。 |
入力 |
無効 |
○ |
実行時オプション |
hyperv.checkJobShutdownInterval |
ジョブ監視間隔(InitiateShutdownメソッド) |
Hyper-Vに要求した処理を監視する,ジョブ監視間隔(InitiateShutdownメソッド)調整用のプロパティです。変更の必要はありません。 |
入力 |
無効 |
○ |
実行時オプション |
[サービス設定]画面および[サービス実行]画面に表示されるプロパティの一覧を次に示します。
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
必須区分 |
プロパティグループ |
---|---|---|---|---|---|---|
hyperv.foreachVmName |
仮想サーバ名(複数指定可) |
仮想サーバの名称を指定します(Hyper-Vにおける仮想サーバの表示名称です。OS上のホスト名ではありません)。複数指定する場合はコンマで区切ってください。99個まで指定できます。 |
入力 |
無効 |
○ |
仮想サーバ情報 |
[タスク詳細]画面にだけ表示されるプロパティの一覧を次に示します。
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
---|---|---|---|---|
common.taskResult |
繰り返しタスクの実行結果 |
タスクごとの成功(true),失敗(false)をコンマ区切りで出力します。 |
出力 |
無効 |
[サービス設定]画面に表示されるプロパティの入力制限を次に示します。
プロパティキー |
入力可能文字 |
---|---|
hyperv.targetHost |
256文字以内の半角英数字および「.」,「-」。 |
hyperv.checkVmStateDisabledCount |
1〜2147483647の整数値。 |
hyperv.checkVmStateDisabledInterval |
1〜60の整数値。 |
hyperv.checkJobShutdownCount |
1〜2147483647の整数値。 |
hyperv.checkJobShutdownInterval |
1〜60の整数値。 |
[サービス設定]画面および[サービス実行]画面に表示されるプロパティの入力制限を次に示します。
プロパティキー |
入力可能文字 |
---|---|
hyperv.foreachVmName |
1024文字以内の文字列。ただし,「<」,「>」,「|」,「;」,「&」,「'」,「"」,「*」,「?」,「[」,「]」,「`」,「%」,「¥」,「/」,「:」を除く。 |
フロー仕様詳細
フロー仕様詳細を次の表に示します。
階層 |
[タスク詳細]画面での表示名 |
ステップ名 |
部品 |
||
---|---|---|---|---|---|
部品名 |
説明 |
エラー時の回復方法 |
|||
1 |
仮想サーバの停止 |
仮想サーバの停止 |
繰り返し部品 |
複数の仮想サーバのOSを強制的にシャットダウンします。 |
エラーの原因を取り除いたあと,サービスを再実行してください。 |