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


-------------- Example 1 Pauses a replication specified by virtual disk name --------------
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
   

-------------- Example 2 Pauses all local active replications by piping objects --------------
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
   

-------------- Example 3 Pauses transfers for eligible replications in all virtual disk groups --------------
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