Set-ReplicaCreationMethod

Article
04/20/2010

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.

Set-ReplicaCreationMethod