NAME
Pause-DcsReplication
SYNOPSIS
Temporarily stops data transfers from the local (active) virtual disk in a replication. This operation can also be performed on a virtual disk group.
SYNTAX
Pause-DcsReplication -Replication <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]
Pause-DcsReplication -VirtualDiskGroup <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Temporarily stops data transfers from the active virtual disk in a replication. This operation can also be performed on a virtual disk group. In order to start data transfers again, the replication must be resumed, see Resume-DcsReplication.
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. The AsyncReplicationData object can be obtained with Get-DcsReplication and the VirtualDiskData object can be obtained with Get-DcsVirtualDisk.
-
- 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 pause the replication data transfer 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 describes the replication relationship and can be used to identify the virtual disk. The VirtualDiskData object can also be used to identify the active (local) virtual disk in the replication.
OUTPUTS
AsyncReplicationData : Object that identifies and describes the replication relationship.
NOTES
Also see Resume-DcsReplication, Get-DcsReplication, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup.
EXAMPLES
Pause-DcsReplication -Replication "Virtual disk 1"
The cmdlet is invoked using the name of the active virtual disk named "Virtual disk 1", for the Replication parameter. This results in pausing the replication for Virtual disk 1.
FirstServerId | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
FirstVirtualDiskId | : | 0dc5596489cb4d8ba0346f80eb47ad46 |
SecondServerId | : | 0d352083-e854-4fbd-a3af-beec1145fed4:867DB6EE-C656-47F7-A160-DCCC35C2D225 |
SecondVirtualDiskId | : | b817122629a64d819a5e96e98a992d24 |
IsActiveSide | : | True |
ReplicationState | : | Active |
FailureStatus | : | NoFailure |
TransferStatus | : | Enabled |
Paused | : | True |
CheckpointSnapshotId | : | |
AutoAsyncReplicationLicense | : | Enabled |
OfflineInitializationSupported | : | True |
InitializationType | : | Online |
OfflineInitializationBuffer | : | |
OfflineInitStatus | : | NoOfflineInit |
InitializationFailureStatus | : | NoFailure |
Id | : | db5abff0-9509-4d4e-b16e-b8c9c403da64 |
Caption | : | Virtual disk 1 |
ExtendedCaption | : | Virtual disk 1 on SSV3 |
Get-DcsReplication -ShowOnlyLocalSide | Pause-DcsReplication
The cmdlet Get-DcsReplication is invoked with the ShowOnlyLocalSide parameter to get all replications on the local server group side. The data is piped to the cmdlet Pause-DcsReplication resulting in all active replications on the local server group side being paused.
FirstServerId | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
FirstVirtualDiskId | : | 0dc5596489cb4d8ba0346f80eb47ad46 |
SecondServerId | : | 0d352083-e854-4fbd-a3af-beec1145fed4:867DB6EE-C656-47F7-A160-DCCC35C2D225 |
SecondVirtualDiskId | : | b817122629a64d819a5e96e98a992d24 |
IsActiveSide | : | True |
ReplicationState | : | Active |
FailureStatus | : | NoFailure |
TransferStatus | : | Disabled |
Paused | : | True |
CheckpointSnapshotId | : | |
AutoAsyncReplicationLicense | : | Enabled |
OfflineInitializationSupported | : | True |
InitializationType | : | Online |
OfflineInitializationBuffer | : | |
OfflineInitStatus | : | NoOfflineInit |
InitializationFailureStatus | : | NoFailure |
Id | : | db5abff0-9509-4d4e-b16e-b8c9c403da64 |
Caption | : | Virtual disk 1 |
ExtendedCaption | : | Virtual disk 1 on SSV3 |
Internal | : | False |
FirstServerId | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
FirstVirtualDiskId | : | 635134ab2cad4b5d81af73ae5f09bd6f |
SecondServerId | : | 0d352083-e854-4fbd-a3af-beec1145fed4:867DB6EE-C656-47F7-A160-DCCC35C2D225 |
SecondVirtualDiskId | : | 15336c814739431fa6d3aa609c1f1922 |
IsActiveSide | : | True |
ReplicationState | : | Active |
FailureStatus | : | NoFailure |
TransferStatus | : | Disabled |
Paused | : | True |
CheckpointSnapshotId | : | |
AutoAsyncReplicationLicense | : | Enabled |
OfflineInitializationSupported | : | True |
InitializationType | : | Online |
OfflineInitializationBuffer | : | |
OfflineInitStatus | : | NoOfflineInit |
InitializationFailureStatus | : | NoFailure |
Id | : | 5b0e64e0-8727-46f6-9644-241d2fcf2955 |
Caption | : | Virtual disk 3 |
ExtendedCaption | : | Virtual disk 3 on SSV3 |
Internal | : | False |
Get-DcsVirtualDiskGroup | where {$_-isNot[DataCore.Executive.SnapshotGroupData ] -and $_ -isNot [DataCore.Executive.RollbackGroupData]} | foreach {Pause-DcsReplication -VirtualDiskGroup $_}
The cmdlet Get-DcsVirtualDiskGroup is invoked to obtain VirtualDiskGroupData objects while excluding SnapshotGroupData and RollbackGroupData objects. The objects are piped into a loop created by using foreach (a PowerShell operation), which performs the operation Pause-DcsReplication for each VirtualDiskGroupData object. Since the VirtualDiskGroup parameter only accepts one object, the foreach loop is one way to perform the operation on multiple objects.
FirstServerId | : | D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0 |
FirstVirtualDiskId | : | b71e83f78bb947268981e235598e7bff |
SecondServerId | : | a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68 |
SecondVirtualDiskId | : | d3a0fbdd7eae488a936cea47d31ddfd9 |
IsActiveSide | : | True |
ReplicationState | : | Active |
FailureStatus | : | NoFailure |
TransferStatus | : | Disabled |
Paused | : | True |
CheckpointSnapshotId | : | |
AutoAsyncReplicationLicense | : | Enabled |
OfflineInitializationSupported | : | True |
InitializationType | : | Online |
OfflineInitializationBuffer | : | |
OfflineInitStatus | : | NoOfflineInit |
InitializationFailureStatus | : | NoFailure |
TestModeStatus | : | Disabled |
Id | : | 176821e1-9d98-4308-ac6c-457a33921a4f |
Caption | : | Virtual disk 1 |
ExtendedCaption | : | Virtual disk 1 on SSVVM3 |
Internal | : | False |
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 | : | Disabled |
Paused | : | True |
CheckpointSnapshotId | : | |
AutoAsyncReplicationLicense | : | Enabled |
OfflineInitializationSupported | : | True |
InitializationType | : | Online |
OfflineInitializationBuffer | : | |
OfflineInitStatus | : | NoOfflineInit |
InitializationFailureStatus | : | NoFailure |
TestModeStatus | : | Disabled |
Id | : | d6b62c88-54f5-4524-86d2-7205fb1200df |
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 | : | Disabled |
Paused | : | True |
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 |