System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレット (Restore-DPMRecoverableItem) について

ブログ エントリ内にアフィリエイト広告が含まれています

System Center 2016 – Data Protection Manager (DPM 2016) の DPM 管理シェルは、PowerShell を用いたコマンドライン インタフェースです。

DPM 管理シェルは、デスクトップ上のアイコン、もしくは [スタート メニュー] – [Microsoft System Center 2016] – [DPM 管理シェル] を選択、クリックすることで起動することが可能です。

DPM 2016 の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。

このヘルプ情報について、「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。

この記事では、「Restore-DPMRecoverableItem」コマンドレットについて記載します (他のコマンドレットについては、「System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレットについて」を参照)。

Restore-DPMRecoverableItem コマンドレット

名前

Restore-DPMRecoverableItem

エイリアス

Recover-RecoverableItem

概要

ターゲットの場所にデータ ソースのバージョンに回復します。

構文

Restore-DPMRecoverableItem [-RecoveryOption] <RecoveryOptions> [[-RecoverableItem] <RecoverableObject[]>] [-AdhocJobsContext <AdhocJobsContext>] [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryNotification <NotificationObject]>] [-RecoveryPointLocation <RecoverySourceLocation[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

説明

Restore-DPMRecoverableItem コマンドレットは、ターゲットの場所に回復可能なアイテムの特定時点のバージョンを回復します。回復可能なアイテムは、データ ソース、もしくはデータ ソース内の回復可能な子アイテムです。

パラメーター

-AdhocJobsContext [<AdhocJobsContext>]

アドホック ジョブのコンテキスト詳細を指定します。Windows PowerShell コマンド ラインからこのパラメーターは使用できません。

必須 false
位置 2
既定値 なし
パイプライン入力を許可する false
ワイルドカード文字を許可する false

-JobStateChangedEventHandler [<JobStateChangedEventHandler>]

Job.StateChanged イベント用のイベント ハンドラーを指定します。コマンドレットに基づくグラフィカル ユーザー インターフェイスを構築するために、-Async パラメーターを用います。System Center 2016 – Data Protection Manager (DPM)  管理シェルではこのパラメーターは使用できません。

必須 false
位置 3
既定値 なし
パイプライン入力を許可する false
ワイルドカード文字を許可する false

-RecoverableItem [<RecoverableObject[]>]

回復可能なアイテム オブジェクトを指定します。これは、回復可能な回復ポイントの子アイテムです。例として、次の項目が含まれます : ファイル システム共有、もしくはボリューム、Microsoft SQL Server データベース、Microsoft Exchange Server 記憶域プール、Microsoft SharePoint サイト、Microsoft Virtual Machine、Microsoft DPM データベース、システム状態、もしくは回復ポイント。

必須 false
位置 2
既定値 なし
パイプライン入力を許可する true (ByValue)
ワイルドカード文字を許可する false

-RecoveryNotification [<NotificationObject]>]

回復の操作が完了したとき、回復の操作が通知を送信する場合に指定します。New-NotificationObjec コマンドレットは、通知オブジェクトを返します。

必須 false
位置 named
既定値 なし
パイプライン入力を許可する false
ワイルドカード文字を許可する false

-RecoveryOption <RecoveryOptions>

データ ソースの回復オプションを指定します。New-DPMRecoveryOption コマンドレットを用いて、回復オプションを作成することが可能です。

必須 true
位置 1
既定値 なし
パイプライン入力を許可する true (ByValue)
ワイルドカード文字を許可する false

-RecoveryPointLocation [<RecoverySourceLocation[]>]

このコマンドレットがリストアする回復ポイントの回復ポイント場所の配列を指定します。回復ポイント場所オブジェクトを取得するには、Get-DPMRecoveryPointLocation コマンドレットを用います。回復アイテムが 1 つ以上の回復ポイントで存在する場合、回復ポイント場所を指定する必要があります。

必須 false
位置 named
既定値 なし
パイプライン入力を許可する True (ByValue)
ワイルドカード文字を許可する false

-Confirm [<SwitchParameter>]

コマンドレットを実行する前に確認のプロンプトを表示します。

必須 false
位置 named
既定値 false
パイプライン入力を許可する false
ワイルドカード文字を許可する false

-WhatIf [<SwitchParameter>]

コマンドレットを実行する場合、何が起きるかを表示します。コマンドレットは実行されません。

必須 false
位置 named
既定値 false
パイプライン入力を許可する false
ワイルドカード文字を許可する false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。

入力

入力の種類は、コマンドレットにパイプ可能なオブジェクトの種類です。

出力

出力の種類は、コマンドレットが発行するオブジェクトの種類です。

例

例 1 : ターゲット場所にデータ ソースのバージョンをリストアする

$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
$PObjects = Get-DPMDatasource -ProtectionGroup $PGroup[0]
$RPoint = Get-DPMRecoveryPoint -Datasource $PObjects[0] | Sort -Property RepresentedPointInTime -Descending | Select-Object -First 1
$ROption = New-DPMRecoveryOption -HyperVDatasource -TargetServer "HVDCenter02" -RecoveryLocation AlternateHyperVServer -RecoveryType Recover -TargetLocation "C:\VMRecovery"
Restore-DPMRecoverableItem -RecoverableItem $RPoint -RecoveryOption $ROption

この例は、回復場所にデータ ソースのバージョンをリストアします。

最初のコマンドは、DPM サーバー「DPMServer02」の保護グループを取得し、変数 $PGroup に格納します。

2 番目のコマンドは、$PGroup 配列の最初の保護グループのデータ ソース一覧を取得、変数 $PObjects に格納します。

3 番目のコマンドは、$PObjects 配列の最初のデータ ソースの回復ポイントを取得し、パイプ操作を用いて Sort-Object コマンドレットに渡します。Sort-Object コマンドレットは、RepresentedPointInTime プロパティにおける日時の値の降順で回復ポイントのコレクションをソートします。 Select-Object コマンドレットは、コレクションから最初の回復を選択し、変数 $RPoint に格納します。詳細については、Get-Help Sort-Object および Get-Help Select-Object と入力してください。

4 番目のコマンドは、サーバー「HVDCenter02」のデータ ソースの回復オプションを作成します。このコマンドは、回復場所として AlternateHyperVServer、DPM が C:\VMRecovery のデータ ソースのレプリカを格納するよう指定します。このコマンドは、変数 $ROption に回復オプションを格納します。

5 番目のコマンドは、$ROption の回復オプションを用いて $RPoint のデータ ソースをリストアします。

関連するリンク

  • Get-DPMDatasource
  • Get-DPMProtectionGroup
  • Get-DPMRecoverableItem
  • Get-DPMRecoveryPoint
  • Get-DPMRecoveryPointLocation
  • New-DPMRecoveryOption
  • New-DPMRecoveryNotification

参考

タイトルとURLをコピーしました