New-DPMPGSet
Creates a DPM protection group set.
Syntax
Default (Default)
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DPMServerName
Specifies the name of a DPM server on which this cmdlet acts.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| 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
(All)
| Position: | 6 |
| Mandatory: | False |
| 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
(All)
| Position: | 7 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
Specifies a name for the protection group set.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | ProtectionGroup[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | False |
| Value from pipeline: | True |
| 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
(All)
| Position: | 4 |
| Mandatory: | False |
| 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
(All)
| Position: | 5 |
| Mandatory: | False |
| 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.