Windows Server 2008 R2のWindows Serverバックアップで使用できるPowerShellコマンドレット (Get-WBVolume) について

スポンサーリンク

Windows Server 2008 R2では、Active Directory (AD) やフェールオーバー クラスタリング (WSFC)、グループ ポリシーといった役割および機能がインストールされたサーバーの管理、もしくは管理したい役割および機能についてリモート サーバー管理ツールをインストールしたサーバー上で、PowerShellコマンドレットを用いて管理することが可能です。

各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、主に英語のみで日本語の情報はあまり公開されていないようです。

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

この記事では、「Get-WBVolume」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2008 R2のWindows Serverバックアップで使用できるPowerShellコマンドレットについて」を参照)。

■名前

Get-WBVolume

■概要

バックアップ ポリシー (WBPolicyオブジェクト) に含まれているバックアップのソース ボリュームの一覧を取得します。

■構文

Get-WBVolume [-AllVolumes] [<CommonParameters>]

Get-WBVolume [-CriticalVolumes] [<CommonParameters>]

Get-WBVolume [-Disk] <WBDisk> [<CommonParameters>]

Get-WBVolume [-Policy] <WBPolicy> [<CommonParameters>]

Get-WBVolume [-VolumePath] <string[]> [<CommonParameters>]

■説明

Get-WBVolumeコマンドレットは、指定されたパラメーターに基づいてボリュームの一覧を取得します。このコマンドレットを使用して、バックアップ ポリシー (WBPolicyオブジェクト) に含まれているボリュームを、すべての重要なボリューム、すべてのボリューム、またはWBDiskオブジェクト内のボリュームから表示することができます。このコマンドレットでは、ボリュームのドライブの文字を使用してWBVolumeオブジェクトを取得することもできます。

■パラメーター

-AllVolumes [<SwitchParameter>]
バックアップ ポリシーに含まれているすべてのボリュームを一覧表示する場合に指定します。

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

-CriticalVolumes [<SwitchParameter>]
バックアップ ポリシー内のすべての重要なボリューム (オペレーティング システムのファイルおよびコンポーネントを含むボリューム) のみを一覧表示する場合に指定します。

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

-Disk <WBDisk>
特定のディスクに関連付けられたボリュームのみを一覧表示する場合に指定します。

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

-Policy <WBPolicy>
情報を表示するバックアップ ポリシー (WBPolicy オブジェクト) を指定します。

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

-VolumePath <string[]>
バックアップを保存するボリュームのボリューム ドライブ文字を表示する場合に指定します。

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

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

■入力

WBPolicy,WBDisk,string

  • Get-WBVolumeコマンドレットは、バックアップ ポリシー (WBPolicyオブジェクト) およびWBDiskオブジェクトをクエリし、バックアップを保存するボリュームのパスを指定する文字列を参照します。
  • 入力パラメーターにより、Get-WBVolumeコマンドレットを以下の目的に使用できます。
    1. WBPolicyオブジェクトをクエリして、バックアップ用に指定されたボリュームの一覧を取得します。
    2. WBDiskオブジェクトをクエリして、特定のディスクに存在するボリュームの一覧を取得します。
    3. 文字列 (VolumePathパラメーター) によって指定されたボリュームの WBVolumeオブジェクトを取得します。
  • さらに、get-WBVolumeコマンドレットを、-CriticalVolumesパラメーターと共に使用すると、システム上のすべての重要なボリュームのWBVolume一覧を取得し、-AllVolumesパラメーターと共に使用すると、システム上のすべてのボリュームのWBVolume一覧を取得できます。

■出力

WBVolume[]

  • Get-WBVolumeコマンドレットは、バックアップ ポリシー (WBPolicyオブジェクト) のボリュームの配列を表示します。

■メモ

  • Get-WBVolumeを使用して取得するボリュームをWBPolicyオブジェクトに追加するには、Add-WBVolumeコマンドレットを使用してバックアップ対象のボリュームとして指定するか、またはNew-WBBackupTargetコマンドレットを使用してバックアップの保存場所として指定します。
  • Windows Serverバックアップの各コマンドレットを使用するには、AdministratorsグループまたはBackup Operatorsグループのメンバーであることが必要です。

■例

例1

 Get-WBVolume -Disk $disks[0] 

例1:説明

特定のディスクに存在するすべてのボリュームを取得します。そのためには、コマンド$disk = Get-WBDiskを実行し、システム上のすべてのディスクの一覧を取得します。次に、この例を使用し、一覧の最初のディスクに存在するすべてのボリュームを使用します。

例2

 Get-WBVolume -Policy $policy 

例2:説明

WBPolicyオブジェクト$policyのバックアップ用に追加されたすべてのボリュームの一覧を取得します。

例3

 Get-WBVolume -VolumePath E: 

例3:説明

ドライブ文字”E:”の付くボリュームのWBVolumeオブジェクトを取得します。

例4

 Get-WBVolume -AllVolumes 

例4:説明

コンピューターに存在するすべてのボリュームのWBVolumeオブジェクトの一覧を取得します。

例5

 Get-WBVolume -CriticalVolumes 

例5:説明

コンピューターに存在するすべての重要なボリューム (オペレーティング システムのコンポーネントおよびファイルを含むボリューム) の一覧を取得します。

■関連するリンク

  • New-WBVolume
  • Get-WBPolicy

[参考]