NAME

Get-DcsReplication

SYNOPSIS

Returns replication data. This operation can also be performed on a virtual disk group.

SYNTAX

Get-DcsReplication   [ -VirtualDisk <Object> ]   [ -Replication <String> ]   [ -ShowOnlyLocalSide]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsReplication   [ -VirtualDiskGroup <Object> ]   [ -Replication <String> ]   [ -ShowOnlyLocalSide]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns replication data. This operation can also be performed on a virtual disk group. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, all replications on all servers (local and remote) in the default connection will be returned.

PARAMETERS

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the local virtual disk in a replication. If specified, only data for that virtual disk will be returned. The VirtualDiskData object can be obtained from Get-DcsVirtualDisk.

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

-Replication<String>
The Async Replication ID (from the AsyncReplicationData object), virtual disk name, or virtual disk ID that identifies a replication. If specified, only data for that replication will be returned.

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

-ShowOnlyLocalSide<SwitchParameter>
If this parameter is specified, only data for source virtual disks that are local for the connection 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

-VirtualDiskGroup<Object>
VirtualDiskGroupData object, name or ID that identifies a virtual disk group. Use this parameter to get replication data for all eligible virtual disks in the virtual disk group. The VirtualDiskGroupData object can be obtained with Get-DcsVirtualDiskGroup.

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

INPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

OUTPUTS

AsyncReplicationData : Object that identifies and describes the relationship between the source and destination virtual disks in a replication.

NOTES

Also see Get-DcsReplicationPartnerGroup, Get-ReplicationBufferFolder, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup.

EXAMPLES


-------------- Example 1 Returns local replications for a specified server by piping objects --------------
Get-DcsVirtualDisk -Server SSV1 -OnlyWithReplications | Get-DcsReplication -ShowOnlyLocalSide

The cmdlet Get-DcsVirtualDisk is used to obtain virtual disk objects for server "SSV1" that are involved with replication. Those objects are piped to Get-DcsReplication which returns data for the local side of those objects.

FirstServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
FirstVirtualDiskId:a2cd4ba379e74d45985f1782c7b88573
SecondServerId:a420399f-ab67-4f87-aed2-39690ae21a5f:BECCFDE2-EEFC-4A6F-B425-5DDF7704DE1B
SecondVirtualDiskId:ef276db503c14e82b285450154f62f14
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:5615bb30-8c01-4086-a331-b83781f3448a
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 on SSV3
Internal:False
   
FirstServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
FirstVirtualDiskId:d4c9888f18004dfabf9542036c1538f1
SecondServerId:a420399f-ab67-4f87-aed2-39690ae21a5f:BECCFDE2-EEFC-4A6F-B425-5DDF7704DE1B
SecondVirtualDiskId:cec88d7114ed4d2c98eb268c21e10c33
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Offline
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:593dca01-9233-4a76-a11d-2f336d2570de
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 on SSV3
Internal:False
   

-------------- Example 2 Returns data for a replication specified by virtual disk name --------------
Get-DcsReplication -VirtualDisk "Virtual disk 1"

Returns data for the replication associated with "Virtual disk 1". Local and remote sides are returned.

FirstServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
FirstVirtualDiskId:a2cd4ba379e74d45985f1782c7b88573
SecondServerId:a420399f-ab67-4f87-aed2-39690ae21a5f:BECCFDE2-EEFC-4A6F-B425-5DDF7704DE1B
SecondVirtualDiskId:ef276db503c14e82b285450154f62f14
IsActiveSide:True
ReplicationState:Active
FailureStatus:NoFailure
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:5615bb30-8c01-4086-a331-b83781f3448a
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 on SSV3
Internal:False
   
FirstServerId:a420399f-ab67-4f87-aed2-39690ae21a5f:BECCFDE2-EEFC-4A6F-B425-5DDF7704DE1B
FirstVirtualDiskId:ef276db503c14e82b285450154f62f14
SecondServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SecondVirtualDiskId:a2cd4ba379e74d45985f1782c7b88573
IsActiveSide:False
ReplicationState:Standby
FailureStatus:BufferFolderNotSet
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
Id:ea566728-56ae-4102-a6a4-a25e1d84b9d0
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1
Internal:False
   

-------------- Example 3 Returns data for a virtual disk group specified by name --------------
Get-DcsReplication -VirtualDiskGroup VDGroup1

Returns data for the replications associated with the virtual disk group named "VDGroup1". Local and remote sides are returned.

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:Enabled
Paused:False
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:a6c68fe8-ea6f-420f-b791-278a02a176eb:AA56BE97-83F3-45B0-B81C-2184A8083E68
FirstVirtualDiskId:d3a0fbdd7eae488a936cea47d31ddfd9
SecondServerId:D3D14D3A-67A2-4E5F-9FA4-262B812EFFA0
SecondVirtualDiskId:b71e83f78bb947268981e235598e7bff
IsActiveSide:False
ReplicationState:Standby
FailureStatus:Offline
TransferStatus:Enabled
Paused:False
CheckpointSnapshotId:
AutoAsyncReplicationLicense:Enabled
OfflineInitializationSupported:True
InitializationType:Online
OfflineInitializationBuffer:
OfflineInitStatus:NoOfflineInit
InitializationFailureStatus:NoFailure
TestModeStatus:Disabled
Id:6b487532-5290-475b-943b-b17d718e652b
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1
Internal:False
   

-------------- Example 4 Returns counter value for data waiting to be replicated for an individual virtual disk. --------------
Get-DcsReplication -VirtualDisk "Virtual disk 1" -ShowOnlyLocalSide  | Get-DcsPerformanceCounter

The cmdlet Get-DcsReplication is invoked with the parameter VirtualDisk, which identifies the virtual disk named "Virtual disk 1". The parameter ShowOnlyLocalSide is included so that only data for the source is returned. This data is piped to the cmdlet Get-DcsPerformanceCounter to return the counter values. The counter that displays the value for data waiting to be replicated is BytesToSend in the returned object.

BytesSent:12288
BytesToSend:4194304
TimeLag:0
InitializationPercentage:100
TestModeProgressPercentage:0
ConsistencyCheckPercentage:100
ReplicationBufferPercentFreeSpace:100
CollectionTime:09/20/2017 9:33:07 PM
NullCounterMap:0