NAME

Reverse-DcsReplication

SYNOPSIS

Reverses the direction of the data transfer between virtual disks used in a replication. This operation can also be performed on a virtual disk group.

SYNTAX

Reverse-DcsReplication   -Replication <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Reverse-DcsReplication   -VirtualDiskGroup <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Reverses the direction of the data transfer between virtual disks used in a replication. This operation can also be performed on a virtual disk group. The current active virtual disk will be deactivated, and the current standby virtual disk will be activated. Paths from the client to the current source will be disabled, and paths from the client to the new source will be enabled.

PARAMETERS

-Replication<Object>
AsyncReplicationData object, VirtualDiskData object, Async Replication ID, virtual disk name, or virtual disk ID that identifies the active virtual disk in the replication. The active virtual disk must be a local virtual disk for the connection. This virtual disk will be deactivated. The AsyncReplicationData object can be obtained with Get-DcsReplication and the VirtualDiskData object can be obtained with Get-DcsVirtualDiskData.

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

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection is 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

-VirtualDiskGroup<Object>
VirtualDiskGroupData object, name or ID that identifies a virtual disk group. Use this parameter to reverse the replication direction for all eligible virtual disks in the virtual disk group. Eligibility may not apply to all virtual disks in the group. The VirtualDiskGroupData object can be obtained with Get-DcsVirtualDiskGroup.

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

INPUTS

AsyncReplicationData or VirtualDiskData : The AsyncReplicationData object identifies and describes the replication relationship. The VirtualDiskData object identifies and describes the current active virtual disk in the replication.

OUTPUTS

AsyncReplicationData : Object that identifies the replication relationship.

NOTES

Also see Stop-DcsDeactivateReplication, Get-DcsReplication, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup.

EXAMPLES


-------------- Example 1 Reverses a replication specified by virtual disk name --------------
Reverse-DcsReplication -Replication "Virtual disk 1"
		

Reverses the replication for the virtual disk named "Virtual disk 1" in the server group.

FirstServerId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
FirstVirtualDiskId:eed9e8f6b02542c3a637e75093b12cfa
SecondServerId:ef23cc60-9003-452d-a291-3dd29aa1f403:2AB62361-B9B9-4A38-B246-3EACF3B19B3A
SecondVirtualDiskId:fc9535748c98442b9d23f9aea0a8067f
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:5d917790-968f-4bf4-8a20-d50b6e832616
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 on SSV3
Internal:False
   

-------------- Example 2 Reverses all replications by piping objects --------------
Get-DcsReplication -ShowOnlyLocalSide | Reverse-DcsReplication
		

The cmdlet Get-DcsReplication is invoked with the switch parameter ShowOnlyLocalSide to obtain all AsynchReplicationData objects for the local server group. The objects are piped to Reverse-DcsReplication resulting in all active local replications being reversed.

FirstServerId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
FirstVirtualDiskId:eed9e8f6b02542c3a637e75093b12cfa
SecondServerId:ef23cc60-9003-452d-a291-3dd29aa1f403:2AB62361-B9B9-4A38-B246-3EACF3B19B3A
SecondVirtualDiskId:fc9535748c98442b9d23f9aea0a8067f
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:5d917790-968f-4bf4-8a20-d50b6e832616
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 on SSV3
Internal:False
   
FirstServerId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
FirstVirtualDiskId:ff69cf72849c49bdb319bb2b61970306
SecondServerId:ef23cc60-9003-452d-a291-3dd29aa1f403:2AB62361-B9B9-4A38-B246-3EACF3B19B3A
SecondVirtualDiskId:becf15f38d004eac81553e1f437dcec5
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:d6097734-4d4d-43da-81b9-2fc86645cc00
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 on SSV3
Internal:False
   
FirstServerId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
FirstVirtualDiskId:50d3414ffbc94c6c9a73f52b67d0d0ae
SecondServerId:ef23cc60-9003-452d-a291-3dd29aa1f403:2AB62361-B9B9-4A38-B246-3EACF3B19B3A
SecondVirtualDiskId:e79d12330c674360a0b6ee0b053dda72
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:5b53983e-07ec-4479-9342-695ef8472335
Caption:Virtual disk 3
ExtendedCaption:Virtual disk 3 on SSV3
Internal:False
   

-------------- Example 3 Reverses replications in a virtual disk group specified by name --------------
Reverse-DcsReplication -VirtualDiskGroup VDGroup2
		

Reverses the eligible replications in the virtual disk group named "VDGroup2" in the server group.

FirstServerId:D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0
FirstVirtualDiskId:14454ab447634aa880c102df9827db72
SecondServerId:a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68
SecondVirtualDiskId:77192956a71845ebb9f214c167d8f2bf
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
TestModeStatus:Disabled
Id:7932cf6f-8857-4702-82b7-61878f2ead2b
Caption:Virtual disk 4
ExtendedCaption:Virtual disk 4 on SSVVM3
Internal:False
   
FirstServerId:D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0
FirstVirtualDiskId:1a2ff247d5aa4b0596eedf8d5835e857
SecondServerId:a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68
SecondVirtualDiskId:9b1763a132cb41389c57a287bfc23414
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
TestModeStatus:Disabled
Id:0b342a3c-48a4-45fb-8773-2a398e1cac32
Caption:Virtual disk 5
ExtendedCaption:Virtual disk 5 on SSVVM3
Internal:False