New-DPMPGSet

New-DPMPGSet

Creates a DPM PG set.

Syntax

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

Detailed Description

The New-DPMPGSet cmdlet creates a new System Center 2012 – Data Protection Manager (DPM) protection group (PG) set. A DPM PG is a collection of protection groups that you collocate on the same tape.

Parameters

-AllowDifferentRetentionPeriods

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DPMServerName<String>

Specifies the name of a DPM server.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ExpiryToleranceUnit<TimeUnit>

Specifies the measurement unit for expiry tolerance.

Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ExpiryToleranceValue<UInt32>

Specifies the maximum length of time for which an expired recovery point can remain on a tape until DPM marks the tape as expired.

Aliases

none

Required?

false

Position?

7

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of the PG set.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PGList<ProtectionGroup[]>

Specifies an array of protection groups to add to the PG set.

Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-WritePeriodUnit<TimeUnit>

Specifies the measurement unit for the write period.

Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WritePeriodValue<UInt32>

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.

Aliases

none

Required?

false

Position?

5

Default Value

none

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.

Notes

  • For more information, type "Get-Help New-DPMPGSet -detailed".

Examples

Example 1: Create a PG set

This example creates a protection group set named PGSET2 on the specified DPM server.

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

The second command creates a PS set named PGSET2 that contains the PGs stored in the $PgList variable.

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

Get-DPMPGSet

Remove-DPMPGSet

Update-DPMPGSet

Get-DPMProtectionGroup