NAME

Enable-DcsReplicationTestMode

SYNOPSIS

Enables replication test mode for a local standby virtual disk.

SYNTAX

Enable-DcsReplicationTestMode   -Replication <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Enable-DcsReplicationTestMode   -VirtualDiskGroup <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Enables replication test mode for a local standby virtual disk. Test mode temporarily activates the standby (destination) virtual disk which temporarily enables all host paths on the standby side. In test mode, users can ensure that paths are correctly configured and hosts have read/write access to the virtual disk. Warning: Test mode can take a considerable amount of time, uses storage allocation overhead, and can affect performance. Do not enable test mode during a disaster. Disable test mode when testing is complete, see Disable-DcsReplicationTestMode. Data changes on the standby virtual disk made during test mode are temporary and will be deleted when test mode is disabled.

PARAMETERS

-Replication<Object>
AsyncReplicationData object, VirtualDiskData object, Async Replication ID, virtual disk name, or virtual disk ID that identifies the standby (destination) virtual disk in the replication. The standby virtual disk must be in the local server group. The AsyncReplicationData object can be obtained from Get-DcsReplication.

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 enable test mode 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 : Object that identifies the standby virtual disk in a replication.

OUTPUTS

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

NOTES

Also see Disable-DcsReplicationTestMode.

EXAMPLES


-------------- Example 1 Enables test mode on a virtual disk specified by name --------------
Enable-DcsReplicationTestMode -Replication RepVD1
		

Test mode is enabled on the standby virtual disk named "RepVD1" in the local server group.

FirstServerId:D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0
FirstVirtualDiskId:a407b0413f9348a2bf645a14d9cf7c57
SecondServerId:a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68
SecondVirtualDiskId:d3a0fbdd7eae488a936cea47d31ddfd9
IsActiveSide:False
ReplicationState:Standby
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
TestModeStatus:Active
Id:3e017326-4f28-417e-bbd2-6dd238743902
Caption:RepVD1
ExtendedCaption:RepVD1 on SSVVM3
Internal:False
   

-------------- Example 2 Enables test mode on all standby virtual disks --------------
Get-DcsReplication -ShowOnlyLocalSide | Enable-DcsReplicationTestMode
		

The cmdlet Get-DcsReplication is invoked on the destination (standby) partner to obtain AsyncReplicationData objects for all local standby virtual disks. Those objects are piped to Enable-DcsReplicationTestMode to enable test mode for those virtual disks in the local server group.

FirstServerId:D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0
FirstVirtualDiskId:a407b0413f9348a2bf645a14d9cf7c57
SecondServerId:a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68
SecondVirtualDiskId:d3a0fbdd7eae488a936cea47d31ddfd9
IsActiveSide:False
ReplicationState:Standby
FailureStatus:Offline
TransferStatus:Unknown
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
TestModeStatus:Active
Id:3e017326-4f28-417e-bbd2-6dd238743902
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 on SSVVM3
Internal:False
   
FirstServerId:D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0
FirstVirtualDiskId:656bb58c14af4e60ac42daf3db74eacd
SecondServerId:a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68
SecondVirtualDiskId:537cd02923d7487bb8371da08d5bcf8e
IsActiveSide:False
ReplicationState:Standby
FailureStatus:Offline
TransferStatus:Unknown
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
TestModeStatus:Active
Id:b48a5f68-9861-4948-b902-0ad1dae78e43
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 on SSVVM3
Internal:False