New-DPMPGSet

Creates a DPM protection group set.

Syntax

New-DPMPGSet
   [[-DPMServerName] <String>]
   [-AllowDifferentRetentionPeriods]
   [-Name] <String>
   [[-PGList] <ProtectionGroup[]>]
   [[-WritePeriodUnit] <TimeUnit>]
   [[-WritePeriodValue] <UInt32>]
   [[-ExpiryToleranceUnit] <TimeUnit>]
   [[-ExpiryToleranceValue] <UInt32>]
   [<CommonParameters>]

Description

The New-DPMPGSet cmdlet creates 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: Create a protection group set

PS C:\>$PGroups = Get-DPMProtectionGroup -DPMServerName "DPMServer07" | where {($_.friendlyname) -match "PG1" -or ($_.friendlyname) -match "PG2"}
PS C:\> New-DPMPGSet -Name "PGSET2" -PGList $PGroups

The first command uses the Get-DPMProtectionGroup cmdlet to get protection groups that have names that contain either PG1 or PG2, and then stores them in the $PGroups variable.

The second command creates a protection set named PGSET2 that contains the protection groups stored in $PGroups.

Parameters

-AllowDifferentRetentionPeriods

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DPMServerName

Specifies the name of a DPM server on which this cmdlet acts.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpiryToleranceUnit

Specifies the measurement unit for expiry tolerance.

The acceptable values for this parameter are:

  • Day
  • Week
  • Month
  • Year
Type:TimeUnit
Accepted values:Invalid, Day, Week, Month, Year
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies a name for the protection group set.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PGList

Specifies an array of protection groups to add to the protection group set. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Type:ProtectionGroup[]
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WritePeriodUnit

Specifies the measurement unit for the write period.

The acceptable values for this parameter are:

  • Day
  • Week
  • Month
  • Year
Type:TimeUnit
Accepted values:Invalid, Day, Week, Month, Year
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False