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