構文
すべての必須およびオプションのパラメータを渡すことにより、特定のリカバリ モードの Runbook を生成して並列実行する構文。
New-HXRunbook -RecoveryMode <String> -ProtectedSiteClusterIP <IPAddress> -ProtectedSiteClusterCreds <PSObject[]> -RecoverySiteClusterIP
<IPAddress> -RecoverySiteClusterCreds <PSObject[]> -ProtectedSiteVCenterIP <IPAddress> -ProtectedSiteVCenterCreds <PSObject[]>
-RecoverySiteVCenterIP <IPAddress> -RecoverySiteVCenterCreds <PSObject[]> [-ParallelRecoveryLimit <Int32>] [-DelayBetweenRecovery
<Int32>] [-DelayInPowerOn <Int32>] [-RunbookFolder <String>] [-ResourcePoolName <String>] [-FolderName <String>] [-TestNetwork
<String>] [-TestVmPrefix <String>] [-NetworkMap <PSObject[]>] [-ProtectionGroup <PSObject[]>]
[-persistConnection] <CommonParameters>
コマンドの実行中にシステムがクレデンシャルを取得できるようにすることで、特定のリカバリ モードの Runbook を並列実行するための構文。
New-HXRunbook -RecoveryMode <String> -ProtectedSiteClusterIP <IPAddress> -RecoverySiteClusterIP <IPAddress> -ProtectedSiteVCenterIP
<IPAddress> -RecoverySiteVCenterIP <IPAddress> [-ParallelRecoveryLimit <Int32>] [-DelayBetweenRecovery <Int32>] [-DelayInPowerOn
<Int32>] [-RunbookFolder <String>] [-ResourcePoolName <String>] [-FolderName <String>] [-TestNetwork <String>] [-TestVmPrefix
<String>] [-NetworkMap <PSObject[]>] [-ProtectionGroup <PSObject[]>]
[-persistConnection] <CommonParameters>
必須パラメータとオプション パラメータをすべて渡すことで、特定のリカバリ モードの Runbook を順番に生成する構文。
New-HXRunbook -RecoveryMode <String> -ProtectedSiteClusterIP <IPAddress> -ProtectedSiteClusterCreds <PSObject[]> -RecoverySiteClusterIP
<IPAddress> -RecoverySiteClusterCreds <PSObject[]> -ProtectedSiteVCenterIP <IPAddress> -ProtectedSiteVCenterCreds <PSObject[]>
-RecoverySiteVCenterIP <IPAddress> -RecoverySiteVCenterCreds <PSObject[]> -SequentialRecovery [-DelayBetweenRecovery <Int32]
[-DelayInPowerOn <Int32>] [-RunbookFolder <String>] [-ResourcePoolName <String>] [-FolderName <String>] [-TestNetwork <String>]
[-TestVmPrefix <String>] [-NetworkMap <PSObject[]>] [-persistConnection]
<CommonParameters>
コマンドの実行時にシステムがクレデンシャルを取得できるようにすることで、特定のリカバリ モードの Runbook を順番に生成する構文。
New-HXRunbook -RecoveryMode <String> -ProtectedSiteClusterIP <IPAddress> -RecoverySiteClusterIP <IPAddress> -ProtectedSiteVCenterIP
<IPAddress> -RecoverySiteVCenterIP <IPAddress> -SequentialRecovery [-DelayBetweenRecovery <Int32>] [-DelayInPowerOn <Int32>][-RunbookFolder
<String>] [-ResourcePoolName <String>] [-FolderName <String>] [-TestNetwork <String>] [-TestVmPrefix <String>] [-NetworkMap
<PSObject[]>] [-persistConnection] <CommonParameters>
JSON ファイルを介してパラメータを渡すことで、特定のリカバリ モードの Runbook を再生成する構文。
New-HXRunbook [-JsonInputFile <String>] [-ProtectedSiteClusterCreds <PSObject[]>] [-RecoverySiteClusterCreds <PSObject[]>]
[-ProtectedSiteVCenterCreds <PSObject[]>] [-RecoverySiteVCenterCreds <PSObject[]>] [-RunbookFolder <String>] [-persistConnection]
[<CommonParameters>]
JSON 設定変数を渡すことで、特定のリカバリ モードの Runbook を再生成する構文。
New-HXRunbook [-JsonConfigVariable <PSObject>] [-ProtectedSiteClusterCreds <PSObject[]>] [-RecoverySiteClusterCreds <PSObject[]>]
[-ProtectedSiteVCenterCreds <PSObject[]>] [-RecoverySiteVCenterCreds <PSObject[]>] [-RunbookFolder <String>] [-persistConnection]
[<CommonParameters>]
説明
さまざまなリカバリ シナリオの Runbook を生成します。新しい-HXRunbook ブックレットは、テスト復元、計画された移行、および障害復旧の各ワークフローをサポートしています。
必須パラメータ
-RecoveryMode <String>
Runbook を生成する必要があるリカバリ モードを指定します。有効なリカバリ モードは、「TestRecovery」、「DisasterRecovery」、および「PlannedMigration」です。
エイリアス
|
モード
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-ProtectedSiteClusterIP <IPAddress>
保護サイト クラスタの IP アドレスを指定します。
エイリアス
|
PriCluIP
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-ProtectedSiteClusterCreds <PSObject[]>
保護サイト クラスタのログイン情報を指定します。
エイリアス
|
PriCluCred
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-RecoverySiteClusterIP <IPAddress>
リカバリサイトクラスタのIPアドレスを指定します。
エイリアス
|
SecCluIP
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-RecoverySiteClusterCreds <PSObject[]>
リカバリ サイト クラスタのログイン情報を指定します。
エイリアス
|
SecCluCred
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-ProtectedSiteVCenterIP <IPAddress>
保護サイトの vCenter サーバーの IP アドレスを指定します。
エイリアス
|
PriVCIP
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-ProtectedSiteVCenterCreds <PSObject[]>
保護サイトの vCenter サーバーのログイン情報を指定します。
エイリアス
|
PriVCCred
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-RecoverySiteVCenterIP <IPAddress>
リカバリ サイトの vCenter サーバーの IP アドレスを指定します。
エイリアス
|
SecVCIP
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-RecoverySiteVCenterCreds <PSObject[]>
リカバリ サイトの vCenter サーバのログイン情報を指定します。
エイリアス
|
SecVCCred
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-JsonInputFile <String>
生成された Runbook の JSON ファイル内の変数を更新して Runbook を再生成する場合は、JSON ファイルで必要な更新を行い、カスタマイズされた JSON 入力ファイルのパスを指定して Runbook を再生成します。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-JsonConfigVariable <PSObject>
生成された Runbook のJSONファイルの変数を更新して Runbook を再生成する場合は、JSON設定変数($ HXJsonConfig)を指定して Runbook を再生成します。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
オプションパラメータ
-ParallelRecoveryLimit <Int32>
同時に複数のリカバリ ジョブを実行する場合の最大制限を指定します。デフォルト値は 10 です。渡される値は 10 以下である必要があります。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-DelayInPowerOn <Int32>
デバイスの電源を最初にオンにしてから、VM に送信されたコマンドに応答を開始するまでの遅延時間を秒単位で指定します。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-SequentialRecovery [<SwitchParameter>]
順番に VM を回復できるように切り替えます。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-DelayBetweenRecovery <Int32>
リカバリ操作が並列または順次実行される場合に、後続の VM のリカバリ操作を遅らせる期間を秒単位で指定します。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
0
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-RunbookFolder <String>
生成された Runbook ファイルを保存する必要がある新しい出力フォルダのパスを指定します。デフォルトのパスは C:\Runbooks
.です。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
"C:\Runbooks"
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-ResourcePoolName <String>
すべての VM を回復または移行する必要があるターゲット リソース プール名を指定します。このプール名は、保護されているすべての VM に適用されます。
エイリアス
|
RPool
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-FolderName <String>
すべての VM を回復または移行する必要があるフォルダ名を指定します。このフォルダ名は、保護されているすべての VM に適用されます。
エイリアス
|
FName
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-TestNetwork <String>
テスト リカバリのテスト ネットワークを指定します。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-TestVmPrefix <String>
テスト リカバリ後に VM に追加する必要があるプレフィックス名を指定します。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-NetworkMap <PSObject[]>
ネットワーク マッピングを次の形式で指定します。
"SourceNetwork1:TargetNetwork1","SourceNetwork2:TargetNetwork2"
エイリアス
|
NMap
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
-ProtectionGroup <PSObject[]>
1 つ以上の保護グループを指定します。
エイリアス
|
グループ
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
PersistConnection [<SwitchParameter>]
Runbook 生成後もクラスタ接続を維持するように切り替えます。
エイリアス
|
—
|
位置
|
[指定(Named)]
|
デフォルト値
|
—
|
パイプライン入力の受付?
|
False
|
ワイルドカード文字使用可?
|
False
|
共通パラメータ
New-HXRunbook cmdlet は次の共通パラメータをサポートします。Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、PipelineVariable、および OutVariable
詳細については、「共通パラメータについて」を参照してください。
例 1
テスト リカバリ シナリオのすべての保護された VM の Runbook を生成します。
Input
New-HXRunbook -RecoveryMode 'TestRecovery' -ProtectedSiteClusterIP "10.10.10.0"
-ProtectedSiteClusterCreds "user","password" -RecoverySiteClusterIP "10.10.10.1"
-RecoverySiteClusterCreds "user","password" -ProtectedSiteVCenterIP "10.10.10.11"
-ProtectedSiteVCenterCreds "user","password" -RecoverySiteVCenterIP "10.10.10.12"
-RecoverySiteVCenterCreds "user","password"
Output
INFO: Generating 'TestRecovery' runbook.
INFO: Runbook has been successfully generated.
INFO: Target Folder:'C:\Runbooks\Runbook-TestRecovery-Parallel_(13-Feb-2019_15-32)'
INFO: Runbook file:'Runbook-TestRecovery-(13-Feb-2019_15-32).ps1'
INFO: Json file:'Json-TestRecovery-(13-Feb-2019_15-32).json'
INFO: Json Configuration Variable:$HXJsonConfig
INFO: Cleanup file:'CleanupScript-TestRecovery-(13-Feb-2019_15-32).ps1'
(注) |
クリーンアップ ファイルは、テスト リカバリ モードでのみ生成されます。クリーンアップ ファイルは、セカンダリ サイトをクリーンアップするために使用されます。
|
例 2
ディザスタ リカバリ シナリオのすべての保護された VM のランブックを生成します。
Input
New-HXRunbook -RecoveryMode 'DisasterRecovery' -ProtectedSiteClusterIP "10.10.10.0"
-ProtectedSiteClusterCreds "user","password" -RecoverySiteClusterIP "10.10.10.1"
-RecoverySiteClusterCreds "user","password" -ProtectedSiteVCenterIP "10.10.10.11"
-ProtectedSiteVCenterCreds "user","password" -RecoverySiteVCenterIP "10.10.10.12"
-RecoverySiteVCenterCreds "user","password"
Output
INFO: Generating 'DisasterRecovery' runbook.
INFO: Runbook has been successfully generated.
INFO: Target Folder: 'C:\Runbooks\Runbook-DisasterRecovery-Parallel_(13-Feb-2019_15-32)'
INFO: Runbook file: 'Runbook-DisasterRecovery-(13-Feb-2019_15-32).ps1'
INFO: Json file: 'Json-DisasterRecovery-(13-Feb-2019_15-32).json'
INFO: Json Configuration Variable: $HXJsonConfig
INFO: ReverseProtect file: 'ReverseProtect_Script_(13-Feb-2019_15-32).ps1'
(注) |
ReverseProtect ファイルは、ディザスタ リカバリ モードでのみ生成されます。ReverseProtect ファイルは、ディザスタ後にセカンダリ サイトを回復するために使用されます。
|
例 3
計画移行シナリオのすべての保護された VM の Runbook を生成します。
Input
New-HXRunbook -RecoveryMode 'PlannedMigration' -ProtectedSiteClusterIP "10.10.10.0"
-ProtectedSiteClusterCreds "user","password" -RecoverySiteClusterIP "10.10.10.1"
-RecoverySiteClusterCreds "user","password" -ProtectedSiteVCenterIP "10.10.10.11"
-ProtectedSiteVCenterCreds "user","password" -RecoverySiteVCenterIP "10.10.10.12"
-RecoverySiteVCenterCreds "user","password"
Output
INFO: Generating 'PlannedMigration' runbook.
INFO: Runbook has been successfully generated.
INFO: Target Folder:'C:\Runbooks\Runbook-PlannedMigration-Parallel_(13-Feb-2019_15-31)'
INFO: Runbook file:'Runbook-PlannedMigration-(13-Feb-2019_15-31).ps1'
INFO: Json file:'Json-PlannedMigration-(13-Feb-2019_15-31).json'
INFO: Json Configuration Variable: $HXJsonConfig
例 4
FolderName や NetworkMap などの追加パラメータを渡すことで、計画移行シナリオのすべての保護された VM の Runbook を生成します。
Input
New-HXRunbook -RecoveryMode 'PlannedMigration' -ProtectedSiteClusterIP "10.10.10.0"
-ProtectedSiteClusterCreds "user","password" -RecoverySiteClusterIP "10.10.10.1"
-RecoverySiteClusterCreds "user","password" -ProtectedSiteVCenterIP "10.10.10.11"
-ProtectedSiteVCenterCreds "user","password" -RecoverySiteVCenterIP "10.10.10.12"
-RecoverySiteVCenterCreds "user","password" -NetworkMap "SourceNetwork1:TargetNetwork1",
"SourceNetwork2:TargetNetwork2" -FolderName "Recovery_Folder"
Output
INFO: Generating 'PlannedMigration' runbook.
INFO: Runbook has been successfully generated.
INFO: Target Folder:'C:\Runbooks\Runbook-PlannedMigration-Parallel_(13-Feb-2019_15-31)'
INFO: Runbook file:'Runbook-PlannedMigration-(13-Feb-2019_15-31).ps1'
INFO: Json file:'Json-PlannedMigration-(13-Feb-2019_15-31).json'
INFO: Json Configuration Variable: $HXJsonConfig
例 5
カスタマイズされた VM の詳細を含む変更された JSON ファイルを渡して、Runbook を生成します。
Input
New-HXRunbook -JsonInputFile "C:\Runbooks\Runbook-TestRecovery-Parallel_(08-Nov-2018_13-28)
\Json-TestRecovery-Parallel_(08-Nov-2018_13-28).json"
Output
INFO: Generating 'TestRecovery' runbook.
INFO: Runbook has been successfully generated.
INFO: Target Folder:'C:\Runbooks\Runbook-TestRecovery-Parallel_(13-Feb-2019_15-32)'
INFO: Runbook file:'Runbook-TestRecovery-(13-Feb-2019_15-32).ps1'
INFO: Json file:'Json-TestRecovery-(13-Feb-2019_15-32).json'
INFO: Json Configuration Variable:$HXJsonConfig
INFO: Cleanup file:'CleanupScript-TestRecovery-(13-Feb-2019_15-32).ps1'
例 6
テスト リカバリ シナリオの特定の保護グループの Runbook を生成します。
Input
New-HXRunbook -RecoveryMode 'TestRecovery' -ProtectedSiteClusterIP "10.10.10.0" -ProtectedSiteClusterCreds
"user","password" -RecoverySiteClusterIP "10.10.10.1" -RecoverySiteClusterCreds "user","password"
-ProtectedSiteVCenterIP "10.10.10.11" -ProtectedSiteVCenterCreds "user","password" -RecoverySiteVCenterIP "10.10.10.12"
-RecoverySiteVCenterCreds "user","password" -ProtectionGroup "group1"
Output
INFO: Generating 'TestRecovery' runbook.
INFO: Runbook has been successfully generated.
INFO: Target Folder:'C:\Runbooks\Runbook-TestRecovery-Parallel_(12-Jun-2019_15-32)'
INFO: Runbook file:'Runbook-TestRecovery-(12-Jun-2019_15-32).ps1'
INFO: Json file:'Json-TestRecovery-(12-Jun-2019_15-32).json'
INFO: Json Configuration Variable:$HXJsonConfig
INFO: Cleanup file:'CleanupScript-TestRecovery-(12-Jun-2019_15-32).ps1'