DPM 2012のDPM管理シェルで使用できるコマンドレット (New-DPMRecoveryPoint) について

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

DPM管理シェルは、DPM 2012の管理を目的として様々なコマンドレットが用意されていますが、 コマンドレットのヘルプについて、英語の情報のみのようです。

このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、意訳したものとなります)。

この記事では、「New-DPMRecoveryPoint (New-RecoveryPoint)」コマンドレットについて記載します (他のコマンドレットについては、「DPM 2012のDPM管理シェルで使用できるコマンドレット一覧について」を参照)。

■名前

New-DPMRecoveryPoint (New-RecoveryPoint)

■概要

データ ソースの新しい回復ポイントを作成します。

■構文

New-DPMRecoveryPoint [-Datasource] <Datasource[]>      [-AdhocJobsContext <AdhocJobsContext>]      [-JobStateChangedEventHandler <JobStateChangedEventHandler>]      -ProtectionType <ProtectionType> -Tape <SwitchParameter>      [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]      [<CommonParameters>] New-DPMRecoveryPoint [-Datasource] <Datasource[]>      [-AdhocJobsContext <AdhocJobsContext>]      [-JobStateChangedEventHandler <JobStateChangedEventHandler>]      -Reserved <SwitchParameter> [-Confirm [<SwitchParameter>]]      [-WhatIf [<SwitchParameter>]] [<CommonParameters>] New-DPMRecoveryPoint [-Datasource] <Datasource[]>      [-AdhocJobsContext <AdhocJobsContext>] [-BackupType <BackupType>]      [-JobStateChangedEventHandler <JobStateChangedEventHandler>]      [-WithDataIntegrityCheck <SwitchParameter>] -Disk <SwitchParameter>      [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]      [<CommonParameters>] New-DPMRecoveryPoint [-Datasource] <Datasource[]>      [-AdhocJobsContext <AdhocJobsContext>]      [-JobStateChangedEventHandler <JobStateChangedEventHandler>]      [-WithDataIntegrityCheck <SwitchParameter>] -Disk <SwitchParameter>      -DiskRecoveryPointOption <CreateDiskRecoveryPointOption>      [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]      [<CommonParameters>]

■説明

New-DPMRecoveryPoint コマンドレットは、データ ソースの新しい回復ポイントを作成します。
-ProtectionTypeパラメーターに有効な値は”ShortTerm”および”LongTerm”です。

■パラメーター

-AdhocJobsContext <AdhocJobsContext>
アドホック ジョブの前後関係詳細。 UIのみ必要となるため、PowerShellから使用する必要はありません。

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

-BackupType <BackupType>
バックアップの種類を示します。有効な値は”ExpressFull”および”Incremental”です。

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

-Datasource <Datasource[]>
Windowsファイル システムの共有またはボリューム、Microsoft SQL Serverデータベース、Microsoft Exchangeストレージ グループ、Microsoft SharePointファーム、Microsoft Virtual Machine、DPMデータベース、または保護グループのメンバーであるシステム状態。

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

-Disk <SwitchParameter>
ディスク上で操作を実行することを示します。

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

-DiskRecoveryPointOption <CreateDiskRecoveryPointOption>
同期中に回復ポイントを作成するかどうか、または同期のみを実行するかどうかを示します。有効な値は”WithSynchronize”、”WithoutSynchronize”、および”OnlySynchronize”です。

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

-JobStateChangedEventHandler <JobStateChangedEventHandler>
JobStateChangedEventHandlerを -Asyncパラメーターと一緒に使用すると、操作の状態をユーザーに通知することができます。これは、コマンドレットを使用したGUIの構築時に役立ちます。ただし、DPM管理シェルの操作時には使用されません。

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

-ProtectionType <ProtectionType>
保護の種類を示します。

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

-Reserved <SwitchProtection>
 

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

-Tape <SwitchParameter>
テープ オブジェクトを示します。

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

-WithDataIntegrityCheck <SwitchParameter>
回復中にデータの整合性チェックを実行することを示します。

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

-Confirm [<SwitchParameter>]
コマンドを実行する前に実行の是非を確認するプロンプトを表示します。

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

-WhatIf [<SwitchParameter>]
実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

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

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

 

■出力

Job

■メモ

詳細については、「Get-Help New-DPMRecoveryPoint -detailed」と入力してください。
技術情報については、「Get-Help New-DPMRecoveryPoint -full」と入力してください。

■例

例1

$pg = Get-ProtectionGroup -DPMServerName TestingServer
$ds = Get-Datasource -ProtectionGroup $pg
New-DPMRecoveryPoint -Datasource $ds -Disk -BackupType expressfull

このコマンドにより、高速完全バックアップが実行され、回復ポイントが作成されます。

例2

$pg = Get-ProtectionGroup -DPMServerName TestingServer
$ds = Get-Datasource -ProtectionGroup $pg
New-DPMRecoveryPoint -Datasource $ds -Disk -DiskRecoveryPointOption withsynchronize

このコマンドにより、同期が実行され、ディスク上にデータ ソースの新しい回復ポイントが作成されます。

例3

$pg = Get-ProtectionGroup -DPMServerName TestingServer
$ds = Get-Datasource -ProtectionGroup $pg
New-DPMRecoveryPoint -Datasource $ds -Tape -ProtectionType ShortTerm

このコマンドにより、種類が短期的に設定されたテープ上にデータ ソースの新しい回復ポイントが作成されます。

[参考]

• DPM Cmdlet Help – System Center 2012 Data Protection Manager
  http://technet.microsoft.com/en-us/library/hh881679.aspx
• New-DPMRecoveryPoint – System Center 2012 Data Protection Manager
  http://technet.microsoft.com/en-us/library/hh881586.aspx
• DPM 2010のDPM管理シェルで使用できるコマンドレット (New-RecoveryPoint) について « 焦げlog
  https://kogelog.com/2011/09/13/20110913-02/