New-DPMPGSet

Creates a DPM protection group set.

Syntax

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

Description

The New-DPMPGSet cmdlet creates a System Center 2016 - 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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DPMServerName

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

Type:String
Required:False
Position:1
Default value:None
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
Parameter Sets:Invalid, Day, Week, Month, Year
Required:False
Position:6
Default value:None
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
Required:False
Position:7
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies a name for the protection group set.

Type:String
Required:True
Position:2
Default value:None
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[]
Required:False
Position:3
Default value:None
Accept pipeline input:True (ByValue)
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
Parameter Sets:Invalid, Day, Week, Month, Year
Required:False
Position:4
Default value:None
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
Required:False
Position:5
Default value:None
Accept pipeline input:False
Accept wildcard characters:False