Set-ReplicaCreationMethod
Set-ReplicaCreationMethod
Set the replica creation method for disk-based protection.
Syntax
Set-ReplicaCreationMethod [-ProtectionGroup] <ProtectionGroup> -Now [-OnlineReplica <SwitchParameter>] [-PassThru <SwitchParameter>] [<CommonParameters>]
Set-ReplicaCreationMethod [-ProtectionGroup] <ProtectionGroup> -Manual <SwitchParameter> [-OnlineReplica <SwitchParameter>] [-PassThru <SwitchParameter>] [<CommonParameters>]
Set-ReplicaCreationMethod [-ProtectionGroup] <ProtectionGroup> -Later <DateTime> [-OnlineReplica <SwitchParameter>] [-PassThru <SwitchParameter>] [<CommonParameters>]
Detailed Description
The Set-ReplicaCreationMethod cmdlet allows you to specify the replica creation method disk-based protection.
The possible values are Now, Later, and Manual. If you do not specify a value, the default is set to Now.
If you specify Now for disk, it will start replication as soon as the protection group is created. In you use -OnlineReplica, the replication to DPM Online will start only after replication to DPM server disk is completed.
The Set-ReplicaCreationMethod cmdlet is the second step to change the replica creation method that is specified for a protection group. First, you must retrieve the replica creation method by using the Get-ReplicaCreationMethod cmdlet.
This cmdlet can only be used if the protection is set to Short-Term for Disk and for Long-Term DPM Online. For any other setting it will show an error. Specifically, this cmdlet does not apply to tape-based protection.
Parameters
-ProtectionGroup
The name of a protection group.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
0 |
-Later
The time at which the operation should be performed.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Manual
Indicates that the settings will be applied manually.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Now
Indicates that the replica has to be created immediately.
Attributes
Name | Value |
---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-OnlineReplica
Indicates that an online replica must be created at initial replication.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-PassThru
The -PassThru parameter can be used with many commands in DPM to return a related object in cases where there is no default output. Using the PassThru parameter allows such cmdlets to be part of a pipeline.
Attributes
Name | Value |
---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-CommonParameter
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Notes
For more information, type "Get-Help Set-ReplicaCreationMethod -detailed".
For technical information, type "Get-Help Set-ReplicaCreationMethod -full".Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.
Examples
EXAMPLE 1
$pg = Get-ProtectionGroup -DPMServerName TestingServer
$mpg = Get-ModifiableProtectionGroup $pg
Set-ReplicaCreationMethod -ProtectionGroup $mpg -Later "23 April 2007"
Set-ProtectionGroup $mpg
This command sets the date for creation of a replica for Trial PG to April 23, 2007.