NAME

Remove-DcsReplicationPartnerGroup

SYNOPSIS

Removes a partner server group used for replications.

SYNTAX

Remove-DcsReplicationPartnerGroup -ReplicationPartnerGroup <Object> [ -Force] [ -Connection <String> ] [ -PipelineVariable <String> ]

Remove-DcsReplicationPartnerGroup -ReplicationPartnerServer <String> [ -Force] [ -Connection <String> ] [ -PipelineVariable <String> ]

DESCRIPTION

Removes a partner server group used for replications. The replication partner group can be removed by specifying the group or server. Once removed, the remote group will no longer be able to replicate virtual disks with the remaining local server group.

PARAMETERS

-ReplicationPartnerGroup<Object>: PartnershipData object, ServerHostGroupData object, Server Host Group name, or Server Host Group ID that identifies the remote server group to remove. The PartnershipData object can be obtained with Get-DcsReplicationPartnerGroup.; Required: true; Position: named; Default value:; Accept pipeline input: true (ByValue); Accept wildcard characters: false
-Force<SwitchParameter>: If the destination server is unreachable and Remove-DcsReplicationPartnerGroup is invoked, the server cannot be removed from the replication group. The Force parameter can be specified to force the operation to complete. WARNING: THIS PARAMETER SHOULD ONLY BE SPECIFIED IN CASE OF EMERGENCY. Do not use this parameter in scripts. 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
-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
-ReplicationPartnerServer<String>: Fully qualified computer name or ID of the server used in the remote replication group to remove.; Required: true; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false

INPUTS

PartnershipData or ServerHostGroupData : ThePartnershipData object identifies and describes a replication partner group. The ServerHostGroupData object, which identifies a server group, can also be used to identify the replication partner group.

OUTPUTS

NOTES

Also see Add-DcsReplicationPartnerGroup, Get-DcsReplicationPartnerGroup, Remove-DcsReplication.

EXAMPLES

-------------- Example 1 Removes replication partner group specified by name --------------

Remove-DcsReplicationPartnerGroup -ReplicationPartnerGroup Remote

Removes the remote replication partner group named "Remote" from the local server group configuration.

-------------- Example 2 Removes a replication partner group by piping object --------------

Get-DcsReplicationPartnerGroup | Remove-DcsReplicationPartnerGroup

The cmdlet Get-DcsReplicationPartnerGroup is used to obtain the PartnershipData object for the replication partner group. The object is piped to the cmdlet Remove-DcsReplicationPartnerGroup which results in the replication partner group being removed.