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

スポンサーリンク

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

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

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

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

■名前

Set-DPMPolicyObjective (Set-PolicyObjective)

■概要

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

■構文

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-RetentionRangeDays] <Int32> [[-SynchronizationFrequencyMinutes] <Int>]
     [-BeforeRecoveryPoint <SwitchParameter>] [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-AlertThresholdInDays] <Int> [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-ColocateDatasources] <Boolean> [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-RetentionRangeInWeeks] <Int32>
     [-ShortTermBackupFrequency] <BackupFrequency>
     [-CreateIncrementals <SwitchParameter>] [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-RetentionRangeList] <RetentionRange[]> [-FrequencyList] <Int[]>
     [-GenerationList] <GenerationType[]> [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-RetentionRange] <RetentionRange>
     [-LongTermBackupFrequency] <BackupFrequency> [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup>
     [-Reserved] <RetentionRange> [-PassThru <SwitchParameter>]
     [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
     [<CommonParameters>]

■説明

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

■パラメーター

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

-Reserved <RetentionRange>

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

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

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

-RetentionRangeDays <Int32>
レプリカの保持日数。

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

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

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

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

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

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

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

-SynchronizationFrequencyMinutes <Int>
分単位での同期の頻度。

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

-Confirm [<SwitchParameter>]
コマンドを実行する前に実行の是非を確認するプロンプトを表示します。

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

-WhatIf [<SwitchParameter>]
実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

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

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

■入力

■出力

Schedule

■メモ

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

■例

例1

$pg = Get-ProtectionGroup -DPMServerName &quot;TestingServer&quot;
$mpg = Get-ModifiableProtectionGroup $pg[0]
Set-DPMPolicyObjective $mpg -RetentionRangeInDays 10 -SynchronizationFrequency 360

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

例2

$rr= new-object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 1,&quot;months&quot;
$pg = Get-ProtectionGroup –DPMServerName “TestingServer”
$mpg=Get-ModifiableProtectionGroup $pg[0]
Set-DPMPolicyObjective -RetentionRange 360 -LongTermBackupFrequency Weekly $mpg

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

例3

&lt;br&gt;$pg = Get-ProtectionGroup –DPMServerName “TestingServer”&lt;br&gt;$mpg=Get-ModifiableProtectionGroup $pg[0]&lt;br&gt;Set-DPMPolicyObjective -RetentionRangeInWeeks 12 -ShortTermBackupFrequency Daily $mpg&lt;br&gt;

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

[参考]

コメント

  1. […] DPM 2012のDPM管理シェルで使用できるコマンドレット (Set-DPMPolicyObjective) について | 焦げloghttps://kogelog.com/2012/08/09/20120809-05/ […]