NAME

Add-DcsReplication

SYNOPSIS

Creates a replication relationship between a source and a destination virtual disk in order to asynchronously mirror data.

SYNTAX

Add-DcsReplication   -SourceServer <String>   -DestinationServer <String>   -SourceDisk <String>   -DestinationDisk <String>   [ -DuplicateDiskId]   [ -OfflineInitialization]   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Creates a replication relationship between a source and a destination virtual disk in order to asynchronously mirror data. After the replication is created, checkpoint markers can be created and used to update snapshots on the destination server, see Set-ReplicationSnapshot and Set-ReplicationCheckPoint.

PARAMETERS

-SourceServer<String>
Computer name or ID of the local source server. The computer name must be unique or the name must be fully qualified.

Required: true
Position: 1
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-DestinationServer<String>
Computer name or ID of the remote destination server. The computer name must be unique or the name must be fully qualified.

Required: true
Position: 2
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-SourceDisk<String>
The name or ID that identifies the virtual disk to be used as the source of the replication. The source disk must exist on the source server.

Required: true
Position: 3
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-DestinationDisk<String>
The name or ID that identifies the virtual disk to be used as the destination of the replication. The destination virtual disk must exist on the destination server.

Required: true
Position: 4
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-DuplicateDiskId<SwitchParameter>
Specify this parameter only if both the source and the destination virtual disks will be served to client hosts that require the same SCSI inquiry ID (virtual product information).

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-OfflineInitialization<SwitchParameter>
Use this parameter to specify offline initialization for this replication. (See Start-DcsReplicationOfflineInitialization to start the initialization.) If not specified, an automatic online initialization will occur.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Yes<SwitchParameter>
Creating a replication is an operation that requires confirmation because the contents of the destination virtual disk will be overwritten. Specify this parameter to confirm your intention to create the replication and prevent user interaction during scripted scenarios.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection will be used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-WhatIf<SwitchParameter>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Confirm<SwitchParameter>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

OUTPUTS

AsyncReplicationData : Object that identifies and describes the relationship between the source and destination virtual disks in the replication.

NOTES

Also see Add-DcsPartnerGroup, Set-DcsReplicationBufferFolder, Set-DcsReplicationCheckPoint, Set-DcsReplicationSnapshot, Reverse-DcsReplication, Start-DcsReplicationOfflineInitialization, Stop-DcsReplicationOfflineInitialization, Set-DcsReplicationInitializationType, Enable-DcsReplicationTestMode.

EXAMPLES


-------------- Example 1 Creates a replication using offline initialization --------------
Add-DcsReplication -SourceServer SSV1 -DestinationServer SSV3 -SourceDisk "Virtual Disk 5" -DestinationDisk "Virtual Disk 6" -OfflineInitialization -Yes
		

Creates a replication relationship between a virtual disk named "Virtual Disk 5" on the Source Server named "SSV1" and the virtual disk named "Virtual Disk 6" on the Destination Server named "SSV3". Offline initialization is specified (see Start-DcsReplicationOfflineInitialization). The parameter Yes is specified to prevent user interaction.

FirstServerId:74EDD1B3-6682-46A7-943C-2F0168CEC699
FirstVirtualDiskId:01cf04e35b5a4f23913c329deb0cc3da
SecondServerId:4d188191-a5b7-4bc1-9ff0-07fa3cddc2a7:863F19DC-41D6-4D46-92A6-30686E3A24AC
SecondVirtualDiskId:a19d230f8c29423f9e23c14d059916c1
IsActiveSide:True
ReplicationState:Initializing
FailureStatus:NoReplicationDefinedForPartner
TransferStatus:Disabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:False
InitializationType:Offline
OfflineInitializationBuffer:
OfflineInitStatus:WaitToStartOfflineInit
InitializationFailureStatus:NoFailure
Id:74c9e07c-e419-48a3-8215-097c89d8bcd0
Caption:Virtual disk 5
ExtendedCaption:Virtual disk 5 on SSV3
Internal:False