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

スポンサーリンク

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

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

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

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

■名前

Add-WBFileSpec

■概要

バックアップに含めるか、またはバックアップから除外する項目を指定するWBFileSpecオブジェクトをバックアップ ポリシー (WBPolicyオブジェクト) に追加します。

■構文

Add-WBFileSpec [-Policy] <WBPolicy> [-FileSpec] <WBFileSpec[]>
     [<CommonParameters>]

■説明

Add-WBFileSpecコマンドレットは、バックアップに含めるか、またはバックアップから除外する項目を指定するWBFileSpecオブジェクトをバックアップ ポリシー (WBPolicyオブジェクト) に追加します。WBFileSpecオブジェクトは、複数のファイル、フォルダー、またはボリュームを含めたり、除外したりすることができます。New-WBFileSpecコマンドレットを使用して、含める項目の一覧を定義し、WBPolicyオブジェクトを更新することができます。

■パラメーター

-FileSpec <WBFileSpec[]>
バックアップ ポリシー (WBPolicyオブジェクト) に追加するWBFileSpecオブジェクトを指定します。

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

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

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

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

■入力

WBFileSpec [], WBPolicy

  • Add-WBFileSpecコマンドレットは、WBFileSpecオブジェクトの項目の一覧をバックアップ ポリシー (WBPolicyオブジェクト) に追加します。

■出力

なし

  • なし

■メモ

  • WBPolicyオブジェクトは編集モードでなければなりません。スケジュール指定バックアップ ポリシーとして設定されているポリシーのWBPolicyオブジェクトを編集モードに切り替えるには、Get-WBPolicyコマンドレットを-Editableパラメーターと共に使用します。New-WBPolicyコマンドレットは、新しいWBPolicyオブジェクトを編集モードの状態で作成します。
  • Windows Serverバックアップの各コマンドレットを使用するには、AdministratorsグループまたはBackup Operatorsグループのメンバーであることが必要です。

■例

例1

&lt;br&gt;$filespec1 = New-WBFileSpec -FileSpec C:sample1.jpg&lt;br&gt;$filespec2 = New-WBFileSpec -FileSpec C:sample*.txt&lt;br&gt;$filespec3 = New-WBFileSpec -FileSpec C:sample*.mp3 -Exclude&lt;br&gt;Add-WBFileSpec -Policy $policy $filespec1,$filespec2,$filespec3&lt;br&gt;

例1:説明

このコマンドは、WBPolicyオブジェクト$policyに3つのファイル指定を追加します。

例2

&lt;br&gt;$filespecarray = ($filespec1, $filespec2, $filespec3)&lt;br&gt;Add-WBFileSpec -Policy $policy $filespecarray&lt;br&gt;

例2:説明

このコマンドは、WBPolicyオブジェクト$policyにファイル指定の配列を追加します。

■関連するリンク

  • Get-WBFileSpec
  • New-WBFileSpec
  • New-WBPolicy

[参考]

スポンサーリンク
スポンサーリンク
スポンサーリンク