NAME

Get-DcsReplicationConsistencyPoint

SYNOPSIS

Retrieves data for the Replication Consistency Point markers for a specified virtual disk group on the destination server.

SYNTAX

Get-DcsReplicationConsistencyPoint   -VirtualDiskGroup <Object>   [ -After <DateTime> ]   [ -Before <DateTime> ]   [ -UserDefinedCode <Byte> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Retrieves data for the Replication Consistency Point markers for a specified virtual disk group on the destination server. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, all markers for the virtual disk group will be returned.

PARAMETERS

-VirtualDiskGroup<Object>
VirtualDiskGroupData object, name or ID that identifies a virtual disk group on the replication destination that have received the markers. The VirtualDiskGroupData object can be obtained with Get-DcsVirtualDiskGroup.

Required: true
Position: 1
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-After<DateTime>
Use this parameter to retrieve marker data that is later in time than the date and time specified as the parameter value. This parameter can be used with the Before parameter in order to retrieve markers within a range of dates and times. (see Example 2) Time should be reflected in UTC. The value can be supplied as a DateTime object. One way to create a DateTime object is using the PowerShell cmdlet Get-Date. The value can also be provided in a string with the date and time, for example "6/16/2015 8:00:00 PM".

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Before<DateTime>
Use this parameter to retrieve marker data that is earlier in time than the date and time specified as the parameter value. This parameter can be used with the After parameter in order to retrieve markers within a range of dates and times. (see Example 2) Time should be reflected in UTC. The value can be supplied as a DateTime object. One way to create a DateTime object is using the PowerShell cmdlet Get-Date. The value can also be provided in a string with the date and time, for example "6/16/2015 8:00:00 PM".

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-UserDefinedCode<Byte>
An optional user-defined code used to identify the marker data to retrieve. If a values is specified, all markers with the same user-defined code will be returned. Valid values are 0 - 255. If a code is not specified, all markers will be returned.

Required: false
Position: named
Default value:
Accept pipeline input: false
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

INPUTS

VirtualDiskGroupData : Object that identifies and describes the virtual disk group that has markers stored on the replication destination.

OUTPUTS

GroupConsistencyPointData : Object that identifies and describes Consistency Point markers received for a virtual disk group at a replication destination. Returned data consists of a timestamp and user-defined code for each marker. The timestamp is the time that the marker was issued on the source side of the replication and is represented in Coordinated Universal Time (UTC).

NOTES

Also see Set-DcsReplicationConsistencyPoint, Add-DcsReplicationConsistencyRollback

EXAMPLES


-------------- Example 1 Returns marker data for a specified virtual disk group and userdefined code --------------
Get-DcsReplicationConsistencyPoint -VirtualDiskGroup "VD Group 1 Remote" -UserDefinedCode 10

The cmdlet is invoked to return the data (TimeStamp and UserDefinedCode) for all markers received by the virtual disk group named "VD Group 1 Remote" that contain the user-defined code of "10". The timestamp is the time that the marker was issued on the source side of the replication.

TimeStamp                                                                                               UserDefinedCode
---------                                                                                               ---------------
6/24/2015 9:41:03 PM                                                                                                 10
6/16/2015 7:56:45 PM                                                                                                 10
6/16/2015 7:41:51 PM                                                                                                 10
		

-------------- Example 2 Returns marker data for a specified virtual disk group that were issued between two dates and times. --------------
Get-DcsReplicationConsistencyPoint -VirtualDiskGroup "VD Group 1 Remote" -After "6/16/2015 8:00:00 PM" -Before "6/25/2105 8:00:00 AM"

The cmdlet is invoked to return the data (TimeStamp and UserDefinedCode) for all markers received by the virtual disk group named "VD Group 1 Remote" that contain the user-defined code of "10". The timestamp is the time that the marker was issued on the source side of the replication.

TimeStamp                                                                                               UserDefinedCode
---------                                                                                               ---------------
6/24/2015 9:41:03 PM                                                                                                 10
6/16/2015 9:21:32 PM                                                                                                  0