Set-DPMPolicyObjective

Syntax

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

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

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

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

Set-DPMPolicyObjective
   [-ProtectionGroup] <ProtectionGroup>
   [-OnlineRetentionRange] <Int32>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

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

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

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

Description

The Set-DPMPolicyObjective cmdlet sets the policy objective for a System Center - 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.

If you specify the protection objective by using the Set-DPMPolicyObjective cmdlet, DPM sets default schedules automatically. To change the default schedules, use the Get-DPMPolicySchedule cmdlet followed by the Set-DPMPolicySchedule cmdlet.

Examples

Example 1: Set the policy objective for a protection group

PS C:\>$PGroup = Get-ProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $MPGroup = Get-ModifiableProtectionGroup $PGroup[0]
PS C:\> Set-DPMPolicyObjective -ProtectionGroup $MPGroup -RetentionRangeInDays 10 -SynchronizationFrequency 360

The first command gets the protection group objects from the DPM server named DPMServer02, and then stores them in the $PGroup variable.

The second command uses standard array notation to specify the second member of the $PGroup array in editable format, and stores the protection group in the $MPGroup variable.

The third command sets the policy objective for the protection group in $MPGroup to a retention range of 10 days and synchronization frequency of 6 hours, which is 360 minutes.

Example 2: Set the retention range for a DPM server

PS C:\>$Rr = New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 1,"months"
PS C:\> $PGroup = Get-ProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $MPGroup = Get-ModifiableProtectionGroup $PGroup[0]
PS C:\> Set-DPMPolicyObjective -ProtectionGroup $MPGroup -RetentionRange 360 -LongTermBackupFrequency Weekly

The first command creates a RetentionRange object, and then stores it in the $Rr variable.

The second command gets protection groups from the DPM server named DPMServer02, and then stores them in the $PGroup variable.

The third command uses standard array notation to specify the first member of the $PGroup array in editable form, and stores the editable protection group in the $MPGroup variable.

The fourth command sets the retention range for the protection group to 360 days and the long-term backup frequency to weekly.

Example 3: Set a retention range

PS C:\>$PGroup = Get-ProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $MPGroup = Get-ModifiableProtectionGroup $PGroup[0]
PS C:\> Set-DPMPolicyObjective -RetentionRangeInWeeks 12 -ShortTermBackupFrequency Daily -ProtectionGroup $MPGroup

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 then stores them in the $PGroup variable.

The second command uses standard array notation to specify the first member of the $PGroup array in editable form, and stores the editable protection group in the $MPGroup variable.

The third command sets the retention range for the protection group to 12 weeks and the short-term backup frequency to daily.

Example 4: Set the retention ranges for online protection

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:\> $PGroup = Get-ProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $MPGroup = Get-ModifiableProtectionGroup -ProtectionGroup $PGroup[0]
PS C:\> Set-DPMPolicyObjective -ProtectionGroup $MPGroup -OnlineRetentionRangeList $RRList

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 them in the $PGroup variable.

The seventh command uses standard array notation to specify the first member of the $PGroup array in editable form, and stores the editable protection group in the $MPGroup variable.

The final command sets the online retention ranges for the protection group and the long-term online backup frequency to daily.

Parameters

-AlertThresholdInDays

-BeforeRecoveryPoint

-ColocateDatasources

-Confirm

-CreateIncrementals

-FrequencyList

-GenerationList

-LongTermBackupFrequency

-OnlineRetentionRange

-OnlineRetentionRangeList

-PassThru

-ProtectionGroup

-RetentionRange

-RetentionRangeDays

-RetentionRangeInWeeks

-RetentionRangeList

-ShortTermBackupFrequency

-SynchronizationFrequencyMinutes

-WhatIf

Outputs

Schedule

Related Links

• Get-DPMPolicyObjective
• Get-DPMPolicySchedule
• Set-DPMPolicySchedule