Windows Server 2012 / 2012 R2 における Windows Server Backup 関連のコマンドレット (Start-WBFileRecovery) について

スポンサーリンク

規定ではインストールされていませんが、Windows Server 2012 / 2012 R2 標準の機能として Windows Server Backup (WSB) という基本的なバックアップと回復と行うための一連のウィザードや PowerShell コマンドレットなどの関連ツールを提供しています。

WSB 関連の PowerShell コマンドレットは Windows Server 2008 R2 と比較し、機能強化が行われていますが、ヘルプに関しては英語のみとなっており、日本語による情報はあまり公開されていません。

ここでは、WSB に関する PowerShell コマンドレットの 1 つである「Start-WBFileRecovery」について、日本語の情報として纏めてみました ((他の PowerShell コマンドレットについては、「Windows Server 2012 / 2012 R2 における Windows Server Backup 関連のコマンドレットについて」を参照)。

※Windows Server 2012 / 2012 R2 と比較した際、内容の相違がほとんどないことから、Windows Server 2012 R2 (内容については「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集したものとなります) の情報を元に編集、意訳したものとなります。

■名前

Start-WBFileRecovery

■概要

ファイルの回復操作を開始します。

■構文

Start-WBFileRecovery [-BackupSet] <WBBackupSet> [-SourcePath] <String> [[-TargetPath] <String>] [[-Option] <WBFileRecoveryOptions>] [[-Async]] [[-NoRestoreAcl]] [[-Recursive]] [[-Force]] [<CommonParameters>]

■説明

Start-WBFileRecovery コマンドレットは、ファイル回復操作を開始します。ファイル回復に対し、回復したいファイルと一緒にファイルを回復するためのバックアップ設定を指定する必要があります。

バックアップのボリュームをブラウズするために、Get-WBBackupVolumeBrowsePath コマンドレットを使用します。

■パラメーター

-Async [<SwitchParameter>]
Windows PowerShell は、バックアップが開始された直後にプロンプトに戻り、状態メッセージが表示されないことを示します。

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

-BackupSet <WBBackupSet>
回復ファイルからバックアップ設定を含むバックアップ設定オブジェクトを指定します。

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

-Force [<SwitchParameter>]
確認のプロンプトを表示せずに、回復操作を開始します。既定では、実行前に確認のプロンプトをコマンドレット上に表示します。

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

-NoRestoreAcl [<SwitchParameter>]
指定する場合、ファイルに対するセキュリティ権限は回復後復元しません。

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

-Option <WBFileRecoveryOptions>
ファイル回復のオプションを含むオブジェクトを指定します。オプションは、既に回復したファイルが同じ場所に存在する場合に実行するアクションを指定します。このパラメーターの許容値は以下のとおり。

  • SkipIfExists: Windows Server バックアップが既存のファイルをスキップし、次のファイルの回復を続行します。
  • CreateCopyIfExists: Windows Server バックアップが既存のファイルのコピーを作成し、それに上書きしません。
  • OverwriteIfExists: Windows Server バックアップがバックアップからファイルで既存のファイルに上書きします。

このパラメーターを指定しない場合、コマンドレットは、既定では CreateCopyIfExist オプションを指定します。

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

-Recursive [<SwitchParameter>]
Windows Server バックアップは、それらのフォルダに従属するフォルダ内のファイルと一緒に指定したフォルダからファイルを回復することを示します。既定では、バックアップ操作は指定されたフォルダの直下に存在するファイルを回復します。

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

-SourcePath <String>
バックアップから回復するファイル パスを指定します。Get-WBBackupVolumeBrowsePath コマンドレットから取得するボリューム ブラウズ パスを持つファイル パスの前に追加することが可能です。

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

-TargetPath <String>
回復されたファイルが回復後に保存する場所を指定します。このパラメーターを指定しない場合、バックアップ操作は元の場所にファイルを回復します。

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

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

■入力

  • WBBackupSet, WBFileRecoveryOptions
    • ファイル回復プロセスでは、ファイルを回復するバックアップ設定を含むバックアップ設定オブジェクトを指定します。元の場所にファイルを回復し、回復するファイルが既に元の場所に存在する場合に、回復プロセスはファイル回復オプションを使用します。

■出力

  • System.String
    • -Async パラメータを指定しない場合、回復操作は回復が完了するまで定期的にステータスメッセージが表示されます。回復操作の実行中、操作の状態を取得するために Get-WBJob コマンドレットを使用することが可能です。操作が完了した後、完了した回復操作を取得するために Get-WBJob -Previous 1 コマンドを使用することが可能です。

■メモ

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

■エイリアス

  • なし

■例

例 1: 元の場所にファイルを回復します。

Start-WBFileRecovery -BackupSet $Backup -FilePathToRecover C:Dir1 -Recursive -FileRecoveryOption CreateCopyIfExists -Force

例 1: 出力結果

Recovering files from C:Dir1 :
Completed.

このコマンドは、バックアップ設定名 $Backup からパス「C:Dir1」でファイルを回復し、元の場所に復元します。-Force パラメーターを含むコマンドのため、バックアップは確認のプロンプトなしで続行します。

例 2: 新しい場所へファイルを回復します。

Get-WBBackupVolumeBrowsePath -BackupSet $Backup -VolumeInBackup $Backup.Volume[0]
dir \Server01WsbMountedVolumesWsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963dir1File1.txt
Start-WBFileRecovery -BackupSet $Backup -FilePathToRecover \Server01WsbMountedVolumesWsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963Dir1File1.txt -RecoveryTarget F:Dir1

例 2: 出力結果

\Server01WsbMountedVolumesWsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963

Directory: \Server01WsbMountedVolumesWsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963dir1
Mode                LastWriteTime     Length Name
—-                ————-     —— —-
-a—        12/13/2011   2:35 PM          0 File1.txt

Warning
Start recovery of files from C:Dir1File1.txt to F:Fir1 ?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y

Recovering files from C:Dir1File1.txt :
Completed.

このコマンドは、別の場所「F:Dir1」にファイル名「C:Dir1File1.txt」を回復します。

最初のコマンドは、回復するファイルのボリューム ブラウズ パスを取得するために、Get-WBBackupVolumeBrowsePath コマンドレットを使用します。バックアップ設定内のボリューム配列の最初の要素に、変数 $Backup が指定したバックアップ ファイルを取得するためのボリュームに格納します。

2 番目のコマンドは、ファイル名「File1.txt」に対する最初のコマンドから取得したパスをチェックします。

3 番目のコマンドは、パス「F:Dir1」へファイル名「File1.txt」をリストアします。

■関連するトピック

  • Get-WBBackupVolumeBrowsePath

[参考]