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

スポンサーリンク

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

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

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

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

■名前

Add-WBVolume

■概要

バックアップ ポリシーに、ソース ボリュームのリストを追加します。

■構文

Add-WBVolume [-Policy] <WBPolicy> [-Volume] <WBVolume[]> [<CommonParameters>]

■説明

Add-WBVolume コマンドレットは WBPolicy オブジェクトにソース ボリュームの一覧を追加します。

このコマンドレットを使用するには、Administrators グループ、もしくは Backup Operators グループのメンバーである必要があります。

■パラメーター

-Policy <WBPolicy>
更新するバックアップ ポリシーが含まれる WBPolicy オブジェクトを指定します。

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

-Volume <WBVolume[]>
WBPolicy
オブジェクトに追加するためにボリュームの配列を指定します。

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

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

■入力

  • WBVolume [], WBPolicy
    • Add-WBVolume コマンドレットは、入力としてバックアップおよび WBPolicy オブジェクトの新しいソース ボリュームの一覧が含まれる WBVolume オブジェクトを許可します。

■出力

  • WBVolume[]
    • Add-WBVolume コマンドレットはコマンドレットにちょうど追加した WBVolume オブジェクトを含む WBPolicy オブジェクトの WBVolume オブジェクトの一覧を出力します。

■メモ

WBPolicy オブジェクトを編集モードにする必要があります。スケジュールされたバックアップ ポリシーとして設定されたポリシーに対して、WBPolicy オブジェクトを編集モードとするには、-Editable パラメーターとともに Get-WBPolicy コマンドレットを使用します。New-WBPolicy コマンドレットは、すでに編集モードにある新しい WBPolicy オブジェクトを作成します。

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

■エイリアス

  • なし

■例

例 1: バックアップ ポリシーにボリュームの一覧を追加する。

$Volumes = Get-WBVolume
$Policy = Get-WBPolicy
Add-WBVolume -Policy $Policy -Volume $Volumes

この例では、WBPolicy オブジェクトにバックアップのボリュームの一覧を追加します。

最初のコマンドは、変数 $VolumesGet-WBVolume コマンドレットの出力を格納します。

2 番目のコマンドは、変数 $Policy に  Get-WBPolicy コマンドレットを呼び出し、結果を割り当てます。

3 番目のコマンドは、バックアップ ポリシーに変数 $Volumes 内のボリュームを追加します。

■関連するトピック

  • Get-WBPolicy
  • Get-WBVolume
  • Remove-WBVolume

[参考]