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
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 |
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 |