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

関連トピック

Get-DPMPolicyObjective

Get-DPMPolicySchedule

Set-DPMPolicySchedule