New-DPMPGSet
New-DPMPGSet
Creates a DPM protection group set.
Syntax
Parameter Set: Default
New-DPMPGSet [[-DPMServerName] <String> ] [-Name] <String> [[-PGList] <ProtectionGroup[]> ] [[-WritePeriodUnit] <PGSet+TimeUnit> {Invalid | Day | Week | Month | Year} ] [[-WritePeriodValue] <UInt32> ] [[-ExpiryToleranceUnit] <PGSet+TimeUnit> {Invalid | Day | Week | Month | Year} ] [[-ExpiryToleranceValue] <UInt32> ] [-AllowDifferentRetentionPeriods] [ <CommonParameters>]
Detailed Description
The New-DPMPGSet cmdlet creates a System Center 2012 – Data Protection Manager (DPM) protection group set. A DPM protection group 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 protection group 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 on which this cmdlet acts.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ExpiryToleranceUnit<PGSet+TimeUnit>
Specifies the measurement unit for expiry tolerance. Valid values are:
-- Day
-- Week
-- Month
-- Year
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 remains on a tape before 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 a name for the protection group 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 protection group set. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-WritePeriodUnit<PGSet+TimeUnit>
Specifies the measurement unit for the write period. Valid values are:
-- Day
-- Week
-- Month
-- Year
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.
Examples
Example 1: Create a protection group set
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.
PS C:\> $PGroups = Get-DPMProtectionGroup -DPMServerName "DPMServer07" | where {($_.friendlyname) -match "PG1" -or ($_.friendlyname) -match "PG2"}
PS C:\> New-DPMPGSet -Name "PGSET2" -PGList $PGroups