Set-DPMPolicyObjective
Set-DPMPolicyObjective
Sets the policy objective for a protection group.
構文
Parameter Set: ShortTermDisk
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-RetentionRangeDays] <Int32> [[-SynchronizationFrequencyMinutes] <Int32> {15 | 30 | 45 | 60 | 120 | 240 | 360 | 720 | 1440} ] [-BeforeRecoveryPoint] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AlertThresholdInDays
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-AlertThresholdInDays] <Int32> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ColocateDatasources
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-ColocateDatasources] <Boolean> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: LongTermCloud
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-OnlineRetentionRange] <Int32> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: LongTermCloudGFS
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-OnlineRetentionRangeList] <RetentionRange[]> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: LongTermTape
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-RetentionRange] <RetentionRange> [-LongTermBackupFrequency] <BackupFrequency> {Daily | Weekly | BiWeekly | Monthly | Quarterly | HalfYearly | Yearly} [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: LongTermTapeCustom
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-RetentionRangeList] <RetentionRange[]> [-FrequencyList] <Int32[]> [-GenerationList] <GenerationType[]> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ShortTermTape
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-RetentionRangeInWeeks] <Int32> [-ShortTermBackupFrequency] <BackupFrequency> {Daily | Weekly | BiWeekly | Monthly | Quarterly | HalfYearly | Yearly} [-CreateIncrementals] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Set-DPMPolicyObjective cmdlet sets the policy objective for a System Center 2012 – Data Protection Manager (DPM) protection group. You can set the policy to back up to disk or tape and specify a retention range for the protection group.
DPM sets default schedules automatically if you specify the protection objective by using the Set-DPMPolicyObjective cmdlet. To change the default schedules, use the Get-PolicySchedule cmdlet followed by the Set-DPMPolicySchedule cmdlet.
パラメーター
-AlertThresholdInDays<Int32>
Specifies the number of days after the most recent backup that DPM waits before it raises an alert.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-BeforeRecoveryPoint
Indicates that DPM runs synchronization before it creates recovery points.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ColocateDatasources<Boolean>
Indicates whether DPM enables colocation.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-CreateIncrementals
Indicates that DPM creates incremental backups.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-FrequencyList<Int32[]>
Specifies an array of backup frequencies that the three protection objectives define. The frequency list can contain any combination of the following values:
-- 6 (yearly)
-- 5 (half yearly)
-- 4 (quarterly)
-- 3 (monthly)
-- 2 (biweekly)
-- 1 (weekly)
-- 0 (daily)
エイリアス |
none |
必須? |
true |
位置は? |
3 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-GenerationList<GenerationType[]>
Specifies an array of generations that the three protection objectives define. The generation list can include any combination of these values:
-- GreatGrandfather
-- Grandfather
-- Father
-- Son
エイリアス |
none |
必須? |
true |
位置は? |
4 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-LongTermBackupFrequency<BackupFrequency>
Specifies the backup frequency for long-term protection. Vaid values for this parameter are:
-- Daily
-- Weekly
-- BiWeekly
-- Monthly
-- Quarterly
-- HalfYearly
-- Yearly
エイリアス |
none |
必須? |
true |
位置は? |
3 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-OnlineRetentionRange<Int32>
Specifies the retention range for online protection.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-OnlineRetentionRangeList<RetentionRange[]>
Specifies an array of retention periods that define the retention ranges for online protection.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-PassThru
Indicates that the cmdlet generates output. By default, this cmdlet does not generate output. You can use the PassThru parameter in order to use the cmdlet in a pipeline.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ProtectionGroup<ProtectionGroup>
Specifies the name of a protection group.
エイリアス |
none |
必須? |
true |
位置は? |
1 |
既定値 |
none |
パイプライン入力を許可する |
True (ByValue) |
ワイルドカード文字を許可する |
false |
-RetentionRange<RetentionRange>
Specifies the duration for which DPM keeps data on tape for long-term protection.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-RetentionRangeDays<Int32>
Specifies the number of days for which DPM keeps a replica.
エイリアス |
RetentionRangeInDays |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-RetentionRangeInWeeks<Int32>
Specifies the number of weeks for which DPM keeps a replica.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-RetentionRangeList<RetentionRange[]>
Specifies an array of retention periods that the three protection objectives define.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ShortTermBackupFrequency<BackupFrequency>
Specifies the backup frequency for short-term protection. Valid values for this parameter are:
-- Weekly
-- Daily
-- Weekly
-- BiWeekly
-- Monthly
-- Quarterly
-- HalfYearly
-- Yearly
エイリアス |
none |
必須? |
true |
位置は? |
3 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-SynchronizationFrequencyMinutes<Int32>
Specifies the frequency of synchronization, in minutes.
エイリアス |
SynchronizationFrequency |
必須? |
false |
位置は? |
3 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
- Schedule
注
For more information, type "
Get-Help Set-DPMPolicyObjective -detailed
".For technical information, type "
Get-Help Set-DPMPolicyObjective -full
".
例
Example 1: Set the policy objective for a protection group
This example sets the policy objective for a protection group.
The first command gets the protection group objects from the DPM server named DPMServer02 and stores the protection group objects in the $Pg variable.
The second command uses standard array notation to specify the second member of the $Pg array (at element 1) in editable format, and stores the protection group in the $Mpg variable.
The third command sets the policy objective for the protection group in the $Mpg variable to a retention range of 10 days and synchronization frequency of 6 hours (360 minutes).
PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer02"PS C:\> $Mpg = Get-ModifiableProtectionGroup $Pg[0]PS C:\> Set-DPMPolicyObjective $Mpg -RetentionRangeInDays 10 -SynchronizationFrequency 360
Example 2: Set the retention range for a DPM server
This example sets the retention range for frequency DPM server.
The first command creates a RetentionRange object.
The second command gets protection groups from the DPM server named DPMServer02 and stores the protection groups in the $Pg variable.
The third command uses standard array notation to specify the first member of the $Pg array (at position 0) in editable form, and stores the editable protection group in the $Mpg variable.
The fourth command sets the retention range for the protection group to 360 days and the long-term backup frequency to weekly.
PS C:\> $rr = New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 1,"months"PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer02"PS C:\> $Mpg = Get-ModifiableProtectionGroup $Pg[0]PS C:\> Set-DPMPolicyObjective -RetentionRange 360 -LongTermBackupFrequency Weekly $Mpg
Example 3: Set a retention range
This example shows another way to set a retention range for a DPM server.
The first command gets protection groups from the DPM server named DPMServer02 and stores the protection groups in the $Pg variable.
The second command uses standard array notation to specify the first member (at position 0) of the $Pg array in editable form, and stores the editable protection group in the $Mpg variable.
The third command sets the retention range for the protection group to 12 weeks and the short-term backup frequency to daily.
PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer02"PS C:\> $Mpg = Get-ModifiableProtectionGroup $Pg[0]PS C:\> Set-DPMPolicyObjective -RetentionRangeInWeeks 12 -ShortTermBackupFrequency Daily $Mpg
Example 4: Set the retention ranges for online protection
This example sets the retention ranges for online protection.
The first command creates a RetentionRange object array stored in the $RRlist variable.
The second, third, fourth and fifth commands create RetentionRange objects, and add them to $RRlist.
The sixth command gets protection groups from the DPM server named DPMServer02, and then stores those protection groups in the $Pg variable.
The seventh command uses standard array notation to specify the first member of the $Pg array in editable form, and stores the editable protection group in the $Mpg variable. The first member is at position 0.
The eighth command sets the online retention ranges for the protection group and the long-term online backup frequency to daily.
PS C:\> $RRlist = @()
PS C:\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 180, Days)
PS C:\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 104, Weeks)
PS C:\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 60, Month)
PS C:\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 10, Years)
PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Mpg = Get-ModifiableProtectionGroup $Pg[0]
PS C:\> Set-DPMPolicyObjective -ProtectionGroup $Mpg -OnlineRetentionRangeList $RRList