NAME

Set-DcsReplicationCheckPoint

SYNOPSIS

Sends a checkpoint marker to the virtual disk in a replication. This operation can also be performed on a virtual disk group.

SYNTAX

Set-DcsReplicationCheckPoint   -Replication <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsReplicationCheckPoint   -VirtualDiskGroup <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sends a checkpoint marker to the virtual disk in a replication. This operation can also be performed on a virtual disk group. When the operation is performed on a virtual disk group, all replications for the virtual disks in the group will be resolved and a checkpoint marker will be set for all applicable virtual disks on the local active side. (The rest will be ignored.) The checkpoint is inserted in the data stream of a local active virtual disk involved in a replication. When received at the destination, the checkpoint can initiate other operations. A checkpoint can be used to update an existing designated snapshot (see Set-DcsReplicationSnapshot) or as a trigger in tasks (see Add-DcsTrigger).

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 send the checkpoint marker to the destination. 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 set the checkpoint for all eligible virtual disks in the virtual disk group. All replications will be resolved for the virtual disks in the group and a checkpoint marker will be set for all applicable virtual disks on the local active side. 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 virtual disk in the replication which will send the checkpoint marker.

OUTPUTS

AsyncReplicationData : The object identifies and describes the replication relationship.

NOTES

Checkpoints should always be marked (sent) when virtual disks are healthy and the replication transfer status is healthy. Data on the source virtual disk should be in a known good state. The virtual disk must be in the Active replication state. Checkpoints cannot be sent if the buffer is full or missing. Warning: If this cmdlet is invoked and those conditions are not met, then the checkpoint will not be sent. Do not send checkpoints when the virtual disk is in recovery, the snapshot may not be valid. Also see Set-DcsReplicationSnapshot, Get-DcsReplication, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup, Add-DcsTrigger, Add-DcsTask.

EXAMPLES

Set-DcsReplicationCheckPoint -Replication "Virtual disk 2"
		

Get-DcsReplication -ShowOnlyLocalSide | Set-DcsReplicationCheckPoint
		

Set-DcsReplicationCheckpoint -VirtualDiskGroup VDGroup2