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> Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> |
■説明
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>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
■出力
Schedule
■メモ
詳細については、「Get-Help Set-DPMPolicyObjective -detailed」と入力してください。
技術情報については、「Get-Help Set-DPMPolicyObjective -full」と入力してください。
■例
例1
$pg = Get-ProtectionGroup -DPMServerName "TestingServer" $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,"months" $pg = Get-ProtectionGroup –DPMServerName “TestingServer” $mpg=Get-ModifiableProtectionGroup $pg[0] Set-DPMPolicyObjective -RetentionRange 360 -LongTermBackupFrequency Weekly $mpg
このコマンドにより、TestingServerの保有期間の範囲が毎週のバックアップ頻度で360日間に設定されます。
例3
<br>$pg = Get-ProtectionGroup –DPMServerName “TestingServer”<br>$mpg=Get-ModifiableProtectionGroup $pg[0]<br>Set-DPMPolicyObjective -RetentionRangeInWeeks 12 -ShortTermBackupFrequency Daily $mpg<br>
このコマンドにより、TestingServerの保有期間の範囲が毎日のバックアップ頻度で12週間に設定されます。
[参考]
- DPM Cmdlet Help - System Center 2012 Data Protection Manager
http://technet.microsoft.com/en-us/library/hh881679.aspx - Set-DPMPolicyObjective - System Center 2012 Data Protection Manager
http://technet.microsoft.com/en-us/library/hh881762.aspx - DPM 2010のDPM管理シェルで使用できるコマンドレット (Set-PolicyObjective) について « 焦げlog
https://kogelog.com/2011/09/22/20110922-02/
コメント
[…] Set-DPMPolicyObjective(Set-PolicyObjective) […]
[…] DPM 2012のDPM管理シェルで使用できるコマンドレット (Set-DPMPolicyObjective) について | 焦げloghttps://kogelog.com/2012/08/09/20120809-05/ […]