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

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

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

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

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

■名前

Set-PolicyObjective

■概要

保護グループのポリシー目標を設定します。

■構文

Set-PolicyObjective [-RetentionRange] [-LongTermBackupFrequency] [-ProtectionGroup]      [-PassThru] [<CommonParameters>] Set-PolicyObjective [-AlertThresholdInDays] [-ProtectionGroup] [-PassThru]      [<CommonParameters>] Set-PolicyObjective [-GenerationList] [-RetentionRangeList] [-FrequencyList]      [-ProtectionGroup] [-PassThru] [<CommonParameters>] Set-PolicyObjective [-CollocateDatasources] [-ProtectionGroup] [-PassThru]      [<CommonParameters>] Set-PolicyObjective [-ShortTermBackupFrequency] [-ProtectionGroup]      -RetentionRangeInWeeks [-CreateIncrementals] [-PassThru] [<CommonParameters>] Set-PolicyObjective [[-SynchronizationFrequency]] [-RetentionRangeInDays]      [-ProtectionGroup] [-BeforeRecoveryPoint] [-PassThru] [<CommonParameters>] Set-PolicyObjective [-OnlineRetentionRange] [-ProtectionGroup] [-PassThru]      [<CommonParameters>]

■説明

Set-PolicyObjectiveコマンドレットは、保護グループのポリシー目標を設定します。そのポリシーはディスクまたはテープ上に設定することができます。また、保護グループの保有期間の範囲を指定することもできます。
Set-PolicyObjectiveコマンドレットを使用して保護目標を指定すると、既定のスケジュールが自動的に設定されます。既定のスケジュールを変更するには、Get-PolicyScheduleコマンドレットの後にSet-PolicyScheduleコマンドレットを使用します。

■パラメーター

-OnlineRetentionRange
データがDPMオンライン上で存在する期間を示します。

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

-FrequencyList
3つの保護目標で定義されるバックアップ頻度の一覧。頻度の一覧には、”Yearly”=6、”Half Yearly”=5、”Quarterly”=4、”Monthly”=3、”Biweekly”=2、”Weekly”=1、”Daily”=0の各値が含まれます。

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

-SynchronizationFrequency
同期の実行回数。

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

-RetentionRangeList
3つの保護目標で定義される保存期間の一覧。

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

-RetentionRangeInDays
レプリカの保持日数。

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

-AlertThresholdInDays
ラップトップがバックアップされていない場合にアラートを生成する経過日数。

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

-GenerationList
3つの保護目標で定義される世代 (前の3世代) の一覧。

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

-CollocateDatasources
Trueに設定されるとコロケーションを有効にし、Falseに設定されるとコロケーションを無効にします。

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

-LongTermBackupFrequency
長期的な保護の場合のバックアップ頻度。指定可能な値は”Daily”、”Weekly”、”BiWeekly”、”Monthly”、”Quarterly”、”HalfYearly”、および”Yearly”です。

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

-ShortTermBackupFrequency
短期的な保護の場合のバックアップ頻度。

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

-ProtectionGroup
保護グループの名前。

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

-RetentionRange
長期的な保護の場合にデータがテープ上に保存される期間。

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

-RetentionRangeInWeeks
レプリカを保持する週数。

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

-BeforeRecoveryPoint
回復ポイントの作成前に同期が実行されることを示します。

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

-CreateIncrementals
増分バックアップを作成するかどうかを示します。

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

-PassThru
-PassThruパラメーターは DPM の多くのコマンドで使用でき、既定の出力がない場合に関連オブジェクトを返します。-PassThruパラメーターを使用すると、上記のコマンドレットをパイプラインの一部にすることができます。

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

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

■入力

 

■出力

Schedule

■メモ

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

コマンドレットの更新情報については、http://go.microsoft.com/fwlink/?LinkId=95130 (英語の可能性あり) を参照することもできます。

■例

例1

$pg = Get-ProtectionGroup -DPMServerName "TestingServer"
$mpg=Get-ModifiableProtectionGroup $pg[0]
Set-PolicyObjective $mpg -RetentionRangeInDays 10 -SynchronizationFrequency 360

このコマンドにより、保護のポリシー目標の保有期間の範囲および同期の間隔がそれぞれ、10日間、6時間に設定されます。

例2

$rr= new-object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 1,"months"
$pg = Get-ProtectionGroup -DPMServerName "TestingServer"
$mpg = Get-ModifiableProtectionGroup $pg[0]
Set-PolicyObjective -RetentionRange 360 -LongTermBackupFrequency Weekly $mpg

このコマンドにより、TestingServerの保有期間の範囲が毎週のバックアップ頻度で360日間に設定されます。

例3

$pg = Get-ProtectionGroup -DPMServerName "TestingServer"
$mpg=Get-ModifiableProtectionGroup $pg[0]
Set-PolicyObjective -RetentionRangeInWeeks 12 -ShortTermBackupFrequency Daily $mpg

このコマンドにより、TestingServerの保有期間の範囲が毎日のバックアップ頻度で12週間に設定されます。

[参考]

• Set-PolicyObjective
  http://technet.microsoft.com/en-us/library/ff631908.aspx
• DPM 2010 Cmdlets
  http://technet.microsoft.com/en-us/library/ff631926.aspx