Set-DPMReplicaCreationMethod
Sets the replica creation method for disk-based protection.
Syntax
Now (Default)
Set-DPMReplicaCreationMethod
[-ProtectionGroup] <ProtectionGroup>
[-Now]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Later
Set-DPMReplicaCreationMethod
[-ProtectionGroup] <ProtectionGroup>
-Later <DateTime>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Manual
Set-DPMReplicaCreationMethod
[-ProtectionGroup] <ProtectionGroup>
[-Manual]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-DPMReplicaCreationMethod cmdlet sets the replica creation method for disk-based protection. You can set Now, Later, and Manual as the replica creation method. If you do not specify a value, the default replica creation method is Now.
If you specify Now for disk, System Center - Data Protection Manager (DPM) starts replication as soon as you create the protection group.
The Set-DPMReplicaCreationMethod cmdlet is the second step in changing the replication method that you specified for a protection group. You must first get the replica creation method by using the Get-DPMReplicaCreationMethod cmdlet.
You can use this cmdlet to set the replica creation method only if you set the protection type to short-term for disk and long-term for online. You can use the Set-DPMProtectionType to set the protection type for a protection group. If you specify any other type of protection type, this cmdlet returns an error. This cmdlet does not apply to tape-based protection.
Examples
Example 1: Set the replica creation method
PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $MPGroup = Get-DPMModifiableProtectionGroup -ProtectionGroup $PGroup
PS C:\> Set-DPMReplicaCreationMethod -ProtectionGroup $MPGroup -Later "23 April 2013"
PS C:\> Set-DPMProtectionGroup -ProtectionGroup $MPGroup
The first command gets the protection group on the DPM server named DPMServer02, and then stores it in the $PGroup variable.
The second command makes the protection group in $PGroup modifiable, and stores the result in the $MPGroup variable.
The third command sets the replica creation method to Later for the protection group in $MPGroup to create a replica on April 23, 2013.
The fourth command uses the Set-DPMProtectionGroup cmdlet to save your changes.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Later
Specifies the time at which DPM performs the operation.
Parameter properties
| Type: | DateTime |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Later
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Manual
Indicates that you apply settings manually.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Manual
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Now
Indicates that DPM creates the replica immediately.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Now
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PassThru
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
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 |
-ProtectionGroup
Specifies a protection group for which this cmdlet sets the replica creation method. 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: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| 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.