NAME

Remove-DcsReplication

SYNOPSIS

Removes (splits) a replication relationship between two virtual disks on different servers. This operation can also be performed on a virtual disk group.

SYNTAX

Remove-DcsReplication   -Replication <Object>   [ -Force]   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Remove-DcsReplication   -VirtualDiskGroup <Object>   [ -Force]   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Removes (splits) a replication relationship between two virtual disks on different servers. This operation can also be performed on a virtual disk group. The virtual disks will exist, but data changes will no longer be asynchronously mirrored between them.

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 from Get-DcsReplication.

Required: true

Position: 1

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Force<SwitchParameter>

If the destination server is unreachable and Remove-DcsReplication is invoked, the replication cannot be removed. The Force parameter can be specified to force the operation. (Also see Yes parameter description.)WARNING: THIS PARAMETER SHOULD ONLY BE SPECIFIED IN CASE OF EMERGENCY. If data files exist in the replication buffer when the operation is forced, those changes will be lost.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Yes<SwitchParameter>

Removing a replication is an operation that requires confirmation. Specify this parameter to confirm your intention to remove the replication and prevent user interaction during scripted scenarios.

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

-WhatIf<SwitchParameter>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Confirm<SwitchParameter>

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 remove the replication relationships 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 Stop-DcsDeleteReplication, Get-DcsReplication, Remove-DcsReplicationPartnerGroup, Get-DcsReplicationPartnerGroup, Get-DcsReplication, Get-DcsVirtualDiskGroup.

EXAMPLES

Remove-DcsReplication -Replication "Virtual disk 6"
		

Get-DcsReplication -ShowOnlyLocalSide | Remove-DcsReplication
		

Remove-DcsReplication -VirtualDiskGroup VDGroup2