Set-DPMPolicyObjective

Set-DPMPolicyObjective

Sets the policy objective for a protection group.

Syntax

Parameter Set: ShortTermDisk
Set-DPMPolicyObjective [-ProtectionGroup] <ProtectionGroup> [-RetentionRangeDays] <Int32> [[-SynchronizationFrequencyMinutes] <Int32> ] [-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: 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] {GreatGrandfather | Grandfather | Father | Son}[] [-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>]

Detailed Description

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.

Parameters

-AlertThresholdInDays<Int32>

Specifies the number of days after the most recent backup that DPM waits before it raises an alert.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-BeforeRecoveryPoint

Indicates that DPM runs synchronization before it creates recovery points.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ColocateDatasources<Boolean>

Indicates whether DPM enables colocation.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-CreateIncrementals

Indicates that DPM creates incremental backups.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	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)

Aliases	none
Required?	true
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	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

Aliases	none
Required?	true
Position?	4
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-LongTermBackupFrequency<BackupFrequency>

Specifies the backup frequency for long-term protection. Vaid values for this parameter are:

-- Daily
-- Weekly
-- BiWeekly
-- Monthly
-- Quarterly
-- HalfYearly
-- Yearly

Aliases	none
Required?	true
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-OnlineRetentionRange<Int32>

Specifies the retention range for online protection.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	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.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProtectionGroup<ProtectionGroup>

Specifies the name of a protection group.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	True (ByValue)
Accept Wildcard Characters?	false

-RetentionRange<RetentionRange>

Specifies the duration for which DPM keeps data on tape for long-term protection.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RetentionRangeDays<Int32>

Specifies the number of days for which DPM keeps a replica.

Aliases	RetentionRangeInDays
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RetentionRangeInWeeks<Int32>

Specifies the number of weeks for which DPM keeps a replica.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RetentionRangeList<RetentionRange[]>

Specifies an array of retention periods that the three protection objectives define.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	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

Aliases	none
Required?	true
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SynchronizationFrequencyMinutes<Int32>

Specifies the frequency of synchronization, in minutes.

Aliases	none
Required?	false
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

• Schedule

Notes

• For more information, type "Get-Help Set-DPMPolicyObjective -detailed".

  For technical information, type "Get-Help Set-DPMPolicyObjective -full".

Examples

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

Related topics

Get-DPMPolicyObjective

Get-DPMPolicySchedule

Set-DPMPolicySchedule