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

スポンサーリンク

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

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

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

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

■名前

New-DPMRecoveryOption (New-RecoveryOption)

■概要

各種サーバーの回復オプションを設定できます。

■構文

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-AlternateDatabase <String>]
     [-AlternateStorageGroup <String>] [-DatabaseName <String>] [-DPMLibrary <Library>]
     [-IsRecoveryStorageGroup <SwitchParameter>] [-MailboxDisplayName <String>]
     [-MountDatabaseAfterRestore <SwitchParameter>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-RollForwardRecovery <SwitchParameter>] [-SANRecovery <SwitchParameter>]
     [-StorageGroupName <String>] [-TargetLocation <String>]
     -Exchange <SwitchParameter> -ExchangeOperationType <ExchangeOperationType>
     -RecoveryType <RecoveryType> [<CommonParameters>]

New-DPMRecoveryOption [-RecoveryLocation] <RecoveryLocation>
     [-TargetServer] <String> [-AlternateDatabase <String>] [-DPMLibrary <Library>]
     [-IsRecoveryDatabase <SwitchParameter>]
     [-MountDatabaseAfterRestore <SwitchParameter>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-RollForwardRecovery <SwitchParameter>] [-SANRecovery <SwitchParameter>]
     [-TargetLocation <String>] -E14Datasource <SwitchParameter>
     -ExchangeOperationType <ExchangeOperationType> -RecoveryType <RecoveryType>
     [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation>
     [-AlternateDatabaseDetails <AlternateDatabaseDetailsType>]
     [-CopyLogFiles <SwitchParameter>] [-DPMLibrary <Library>]
     [-LeaveDBInRestoringState <SwitchParameter>] [-LogFileCopyLocation <String>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-RollForwardRecovery <SwitchParameter>] [-SANRecovery <SwitchParameter>]
     [-TargetLocation <String>] -RecoveryType <RecoveryType> -SQL <SwitchParameter>
     [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-AlternateLocation <String>]
     [-DPMLibrary <Library>] [-RecoverToReplicaFromTape <Boolean>]
     [-RestoreSecurity <SwitchParameter>] [-SANRecovery <SwitchParameter>]
     -FileSystem <SwitchParameter> -OverwriteType <OverwriteType>
     -RecoveryType <RecoveryType> [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-AlternateLocation <String>]
     [-DPMLibrary <Library>] [-RecoverToReplicaFromTape <Boolean>]
     [-RestoreSecurity <SwitchParameter>] [-SANRecovery <SwitchParameter>]
     -ClientDatasource <SwitchParameter> -OverwriteType <OverwriteType>
     -RecoveryType <RecoveryType> [<CommonParameters>]

New-DPMRecoveryOption [-DPMServerName] <String> [-StagingAreaPath] <String>
     [-DestinationServerName] <String> [-DestinationPath] <String>
     [-DatasourceName] <String> [-OverwriteType] <OverwriteType>
     [[-RestoreSecurity] <SwitchParameter>] [-DPMLibrary <Library>]
     [-FileSystemDatasource <SwitchParameter>] [-RecoverToReplicaFromTape <Boolean>]
     -DPMComponentName <GUID> [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-DPMLibrary <Library>]
     [-ItemLevelRecoveryType <SharepointRecoveryType>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-SANRecovery <SwitchParameter>] [-TargetLocation <String>]
     [-TargetSiteUrl <String>] -DatabaseFileTempLocation <String>
     -ExportFileTempLocation <String> -IntermediateServer <String>
     -IntermediateSqlInstance <String> -RecoveryType <RecoveryType>
     -SharePointSite <SwitchParameter> [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-DPMLibrary <Library>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-SANRecovery <SwitchParameter>] [-TargetLocation <String>]
     -GenericDatasource <SwitchParameter> -RecoveryType <RecoveryType>
     [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-DPMLibrary <Library>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-SANRecovery <SwitchParameter>] [-TargetLocation <String>]
     -HyperVDatasource <SwitchParameter> -RecoveryType <RecoveryType>
     [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-DPMLibrary <Library>]
     [-RecoverToReplicaFromTape <Boolean>] -PrimaryDpmServer <SwitchParameter>
     [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-DPMLibrary <Library>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-SANRecovery <SwitchParameter>] [-TargetLocation <String>]
     -RecoveryType <RecoveryType> -SharePoint <SwitchParameter>
     [<CommonParameters>]

New-DPMRecoveryOption [-TargetServer] <String>
     [-RecoveryLocation] <RecoveryLocation> [-DPMLibrary <Library>]
     [-RecoverToReplicaFromTape <Boolean>] [-RestoreSecurity <SwitchParameter>]
     [-SANRecovery <SwitchParameter>] [-TargetLocation <String>]
     -RecoveryType <RecoveryType> -SystemProtectionDatasource <SwitchParameter>
     [<CommonParameters>]

■説明

New-DPMRecoveryOptionコマンドレットを使用すると、ファイル サーバー、Exchange、SharePointサーバー、SharePointサイト、SQL Server、およびその他のデータ ソースの回復ポイントを設定できます。

■パラメーター

-AlternateDatabase <String>
代替データベースの名前。

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

-AlternateDatabaseDetails <AlternateDatabaseDetailsType>
データベースの種類。

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

-AlternateLocation <String>
回復ポイントを作成する代替場所の名前。

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

-AlternateStorageGroup <String>
新しい回復ポイントの代替ストレージ グループの名前。

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

-ClientDatasource <SwitchParameter>
復元中のデータがファイル システムであるか、またはアプリケーションであるかを示します。

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

-CopyLogFiles <SwitchParameter>
ログ ファイルがコピーされることを示します。

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

-DPMComponentName <GUID>

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

-DPMLibrary <Library>
DPMライブラリ オブジェクト。

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

-DPMServerName <String>
DPMサーバーの名前。

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

-DatabaseFileTempLocation <String>
データベース ファイルの一時的な場所。

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

-DatabaseName <String>
データベースの名前。

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

-DatasourceName <String>
データ ソースの名前。

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

-DestinationPath <String>
回復場所。

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

-DestinationServerName <String>
データの回復先となるサーバーの名前。

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

-E14Datasource <SwitchParameter>
Exchange Server 2010からのデータ ソースであるかどうかを示します。

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

-Exchange <SwitchParameter>
現在の操作がMicrosoft Exchangeデータ ソースで実行されることを示します。

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

-ExchangeOperationType <ExchangeOperationType>
実行される操作の種類を示します。有効な値は”NoOperation”、”MailBoxLevelRecovery”、および”NeedCleanShutdown”です。

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

-ExportFileTempLocation <String>
エクスポート ファイルの場所。

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

-FileSystem <SwitchParameter>
操作がファイル システム データ ソースで実行されることを示します。

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

-FileSystemDatasource <SwitchParameter>
ファイル システム データ ソースを回復することを示します。

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

-GenericDatasource <SwitchParameter>
現在の操作がMicrosoft Virtual Serverなどのデータ ソースで実行されることを示します。

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

-HyperVDatasource <SwitchParameter>
Hyper-Vデータ ソースを示します。

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

-IntermediateServer <String>
SharePointサイトの回復時に使用されるサーバー。そのサーバーにSharePointファームがインストールされている必要があります。

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

-IntermediateSqlInstance <String>
SharePointサイトの回復時に使用されるSQL Serverインスタンス。SQL Serverデータベースを一時的にホストするために使用されます。

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

-IsRecoveryDatabase <SwitchParameter>
データベースが回復用データベースであることを示します。

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

-IsRecoveryStorageGroup <SwitchParameter>
回復が回復ストレージ グループであるかどうかを示します。

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

-ItemLevelRecoveryType <SharepointRecoveryType>

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

-LeaveDBInRestoringState <SwitchParameter>
これは、スイッチ パラメーターです。このパラメーターを使用しない場合、データベースが、非運用状態ではあるが復元可能な状態になることを示します。このパラメーターを使用する場合、データベースが運用状態になることを示します。

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

-LogFileCopyLocation <String>
ログ ファイルのコピー先となる場所。

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

-MailboxDisplayName <String>
メールボックスに表示される名前。

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

-MountDatabaseAfterRestore <SwitchParameter>
復元後にデータベースが自動的にマウントされることを示します。

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

-OverwriteType <OverwriteType>
回復するファイルが既に存在する場合に実行する操作を指定します。指定可能な値は”CreateCopy”、”Skip”、および”Overwrite”です。

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

-PrimaryDpmServer <SwitchParameter>
DPMサーバーへの回復であることを示します。

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

-RecoverToReplicaFromTape <Boolean>
レプリカへの回復がテープから実行されることを示します。

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

-RecoveryLocation <RecoveryLocation>
データの回復先の場所を示します。有効な値は”OriginalServer”、”CopyToFolder”、”OriginalServerWithDBRename”、”AlternateExchangeServer”、および”ExchangeServerDatabase”です。

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

-RecoveryType <RecoveryType>
回復の種類が”Recover”または”Restore”のいずれであるかを示します。Hyper-Vでは、”Recover”のみを使用できます。

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

-RestoreSecurity <SwitchParameter>
復元操作時に使用するセキュリティ設定を示します。
これは、スイッチ パラメーターです。コマンドレットで-RestoreSecurityパラメーターを使用した場合、回復ポイントからのセキュリティ設定が使用されることを示します。-RestoreSecurityパラメーターを使用しない場合、復元先サーバーのセキュリティ設定が使用されることを示します。

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

-RollForwardRecovery <SwitchParameter>
アプリケーションを最新の状態にするために、最新の回復ポイントからアプリケーションを回復し、その回復ポイント以降のすべてのログを適用することを示します。

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

-SANRecovery <SwitchParameter>
現在の操作が記憶域ネットワーク (SAN) データ ソースで実行されることを示します。

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

-SQL <SwitchParameter>
現在の操作がSQL Serverデータ ソースで実行されることを示します。

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

-SharePoint <SwitchParameter>
現在の操作がSharePointデータ ソースで実行されることを示します。

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

-SharePointSite <SwitchParameter>
操作がSharePointサイトで実行されることを示します。

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

-StagingAreaPath <String>
ステージング領域へのパス。

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

-StorageGroupName <String>
ストレージ グループの名前。

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

-SystemProtectionDatasource <SwitchParameter>
システム保護データ ソースを示します。

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

-TargetLocation <String>
レプリカが格納される場所。

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

-TargetServer <String>
回復が実行されるサーバー。
クラスター環境でNew-RecoveryOptionコマンドレットを使用する場合、ターゲット サーバー パラメーターはResourceGroupName.ClusterName.DomainNameの形式で指定する必要があります。

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

-TargetSiteUrl <String>
回復が実行されるURL。

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

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

■入力

■出力

RecoveryOption

■メモ

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

■例

例1

New-DPMRecoveryOption -TargetServer test.contoso.com -RecoveryLocation copytofolder -FileSystem -AlternateLocation &quot;f:restore&quot; -OverwriteType overwrite -RestoreSecurity -RecoveryType Restore

このコマンドにより、ファイル システムがtest.domain.comに回復され、その元のセキュリティ設定が復元されます。

例2

$dpmserver = connect-DPMServer DPMServer1
$ps = Get-ProductionServer DPMServer1
$ds = Get-Datasource $ps
$dl = Get-DPMLibrary DPMServer1
$rp = Get-RecoveryPoint $ds
$rop = New-DPMRecoveryOption -Filesystem -RecoverToReplicaFromTape 1 -RecoveryLocation DPMReplicaVolume -DPMLibrary $dl[0] -Targetserver DPMServer1 -overwritetype overwrite

この例は、レプリカを使用してファイル サーバーを回復するための一連のコマンドの概要について示しています。

例3

$pg = Get-ProtectionGroup
$ds = Get-Datasource $pg
$rp = Get-RecoveryPoint -Datasource $ds
$lib = Get-DPMLibrary
$rop = New-DPMRecoveryOption -RecoverToReplicaFromTape 1 -RecoveryLocation DPMReplicaVolume -FileSystem -TargetServer DPMTestServer -OverwriteType Overwrite -RecoveryType Recover -DpmLibrary $lib&lt;br&gt;Recover-RecoverableItem -RecoverableItem $rp -RecoveryOption $rop

[参考]

コメント

  1. […] DPM 2012のDPM管理シェルで使用できるコマンドレット (New-DPMRecoveryOption) について | 焦げloghttp://kogelog.com/2012/08/02/20120802-01/ […]