Share via

Update-DPMPGSet

Module:
DataProtectionManager Module

Updates and saves changes to a protection group set.

Syntax

AllParams (Default) 

Update-DPMPGSet
    [-PGSet] <PGSet>
    [-Name] <String>
    [-WritePeriodUnit] <TimeUnit>
    [-WritePeriodValue] <UInt32>
    [-ExpiryToleranceUnit] <TimeUnit>
    [-ExpiryToleranceValue] <UInt32>
    [-AllowDifferentRetentionPeriods]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AllowDiffRetnPeriodsFlag 

Update-DPMPGSet
    [-PGSet] <PGSet>
    [-AllowDifferentRetentionPeriods]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemovePG 

Update-DPMPGSet
    [-PGSet] <PGSet>
    [-Remove] <ProtectionGroup>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ChangeName 

Update-DPMPGSet
    [-PGSet] <PGSet>
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ChangeTimePeriods 

Update-DPMPGSet
    [-PGSet] <PGSet>
    [-WritePeriodUnit] <TimeUnit>
    [-WritePeriodValue] <UInt32>
    [-ExpiryToleranceUnit] <TimeUnit>
    [-ExpiryToleranceValue] <UInt32>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AddPG 

Update-DPMPGSet
    [-PGSet] <PGSet>
    [-Add] <ProtectionGroup>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Update-DPMPGSet cmdlet updates and saves changes to a System Center - Data Protection Manager (DPM) protection group set. A DPM protection group is a collection of protection groups that you collocate on the same tape.

Examples

Example 1: Update write period and expiry tolerance

PS C:\>$PGSet = Get-DPMPGSet -DPMServerName "DPMServer07"
PS C:\> Update-DPMPGSet -PGSet $PGSet[0] -Name "PGSset3" -WritePeriodUnit day -WritePeriodValue 60 -ExpiryToleranceUnit Day -ExpiryToleranceValue 10

This example updates the first protection group set from protection group sets on the on the server DPMServer07 with values for write period and expiry tolerance.

The first command uses the Get-DPMPGSet cmdlet to get the protection group sets for the specified server and stores them in the $PGSet variable.

The second command specifies the first member of $PGSet by using standard array notation. The command updates values for write period and expiry tolerance.

Example 2: Add a protection group to a protection group set

PS C:\>$PGSet = Get-DPMPGSet -DPMServerName "DPMServer07"
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer07" | where {($_.friendlyname) -match "PG1" }
PS C:\> Update-DPMPGSet -PGSet $PGSet[0] -Add $PGroup

This example adds a protection group from DPMServer07 to the first protection group set on that DPM server.

The first command uses the Get-DPMPGSet cmdlet to get the protection group sets for the specified server and stores them in the $PGSet variable.

The second command uses the Get-DPMProtectionGroup cmdlet to get a protection group from the specified DPM server that has a name that contains PG1, and then stores it in the $PGroup variable.

The third command specifies the first member of the $PGSet variable by using standard array notation. The command updates that set to contain the protection group stored in $PGroup.

Example 3: Remove a protection group from a protection group set

PS C:\>$PGSet = Get-DPMPGSet -DPMServerName "DPMServer07"
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer07" | where { ($_.friendlyname) -match "PG1" }
PS C:\> Update-DPMPGSet -PGSet $PGSet[0] -Remove $PGroup

This example removes the first protection group set from the list of protection group sets on the DPM server TestingServer.

The first command uses the Get-DPMPGSet cmdlet to get the protection group sets for the specified server and stores them in the $PGSet variable.

The second command uses the Get-DPMProtectionGroup cmdlet to get a protection group from the specified DPM server that has a name that contains PG1, and then stores it in the $PGroup variable.

The third command specifies the first member of $PGSet by using standard array notation. The command updates that set to no longer contain the protection group stored in $PGroup.

Parameters

-Add

Specifies a protection group. The cmdlet adds this protection group to the protection group set.

Parameter properties

Type:ProtectionGroup
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddPG
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowDifferentRetentionPeriods

Indicates that protection groups with different retention periods can be part of the same protection group set.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AllParams
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ExpiryToleranceUnit

Specifies the measurement unit for expiry tolerance. The acceptable values for this parameter are:

  • Day
  • Week
  • Month
  • Year

Parameter properties

Type:TimeUnit
Default value:None
Accepted values:Invalid, Day, Week, Month, Year
Supports wildcards:False
DontShow:False

Parameter sets

AllParams
Position:4
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ChangeTimePeriods
Position:4
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ExpiryToleranceValue

Specifies the maximum length of time for which an expired recovery point remains on a tape before DPM marks the tape as expired.

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AllParams
Position:5
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ChangeTimePeriods
Position:5
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies a new name for the protection group set.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AllParams
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ChangeName
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PGSet

Specifies a protection group set that this cmdlet updates. To obtain a protection group set object, use the Get-DPMPGSet cmdlet.

Parameter properties

Type:PGSet
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Remove

Specifies a protection group. The cmdlet removes this protection group from the protection group set.

Parameter properties

Type:ProtectionGroup
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

RemovePG
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WritePeriodUnit

Specifies the measurement unit for the write period. The acceptable values for this parameter are:

  • Day
  • Week
  • Month
  • Year

Parameter properties

Type:TimeUnit
Default value:None
Accepted values:Invalid, Day, Week, Month, Year
Supports wildcards:False
DontShow:False

Parameter sets

AllParams
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ChangeTimePeriods
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WritePeriodValue

Specifies the length of time for which a tape is available for writing new backups. DPM marks the tape as Offsite Ready after this interval.

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AllParams
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ChangeTimePeriods
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.