NAME

Set-DcsReplicationPartnerGroupProperties

SYNOPSIS

Sets the properties of a remote replication partner group.

SYNTAX

Set-DcsReplicationPartnerGroupProperties   -ReplicationPartnerGroup <Object>   -RemoteUserName <String>   -RemotePassword <String>   [ -Address <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsReplicationPartnerGroupProperties   -ReplicationPartnerGroup <Object>   [ -EnableCompression <Boolean> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsReplicationPartnerGroupProperties   -ReplicationPartnerServer <String>   -RemoteUserName <String>   -RemotePassword <String>   [ -Address <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsReplicationPartnerGroupProperties   -ReplicationPartnerServer <String>   [ -EnableCompression <Boolean> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets the properties of a remote replication partner group. Specify the parameters to change or set. If a parameter is not specified, it will not be changed from the current setting.

PARAMETERS

-ReplicationPartnerGroup<Object>
PartnershipData object, ServerHostGroupData object, Server Host Group name, or Server Host Group ID that identifies the remote replication partner group. The remote group can be identified using this parameter or the parameter ReplicationPartnerServer.

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

-RemoteUserName<String>
The user name of the account used to connect to the remote server group. User names must match Windows user accounts and must reside on all servers in the remote server group. Credentials can be domain-wide or local (workgroup). If credentials are domain-wide, include the domain with the name.

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

-RemotePassword<String>
The login password that corresponds to the remote user name.

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

-Address<String>
The server name or IP address of a server in the remote replication partner group used to make the connection. This remote server will field communications from the local group. If an IP address is specified, only that address will be used. For instance, valid values could be an IP address such as "172.99.99.99" or a server name such as "SSV1".

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

-EnableCompression<Boolean>
Use this parameter to set whether or not to enable data compression. Specify $true to enable data compression or $false to disable data compression on the remote replication server. By default data compression is enabled for remote replication servers. If replication data is already compressed in some other manner on the remote replication server, such as through a hardware VPN device with native compression, then data compression is not required and can be disabled.

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

-ReplicationPartnerServer<String>
Name of any server in the remote replication partner group. This server will be used to identify the remote replication partner group. The remote group can be identified using this parameter or the parameter ReplicationPartnerGroup.

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

INPUTS

PartnershipData or ServerHostGroupData : Object that identifies the replication partner group.

OUTPUTS

PartnershipData : Object that identifies the replication partner group.

NOTES

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

EXAMPLES


-------------- Example 1 Enables compression for a replication partner group specified by name --------------
Set-DcsReplicationPartnerGroupProperties -ReplicationPartnerGroup REMOTE -EnableCompression $True
		

Data compression is enabled for the replication partner group named REMOTE.

GroupId:a1ce3063-d80c-4aa7-90f6-a528aa3d2a20
HostAddresses:{13.0.0.40}
IncomingCredentials:DataCore.Executive.ConnectionCredentials
OutgoingCredentials:DataCore.Executive.ConnectionCredentials
Connected:True
EnableCompression:True
Id:8c9bba43-cc5d-4d7d-bbda-0282a8fb492f
Caption:ControllerProxy
ExtendedCaption:ControllerProxy
Internal:False
   

-------------- Example 2 Changes the remote user name and password --------------
Set-DcsReplicationPartnerGroupProperties -ReplicationPartnerServer SSV3 -RemoteUserName LHoward -RemotePassword $LH03421d
		

Changes the user name and password for the remote replication partner server SSV3. The user name is set to LHoward and the password is set to $LH03421d.

GroupId:a1ce3063-d80c-4aa7-90f6-a528aa3d2a20
HostAddresses:{13.0.0.40}
IncomingCredentials:DataCore.Executive.ConnectionCredentials
OutgoingCredentials:DataCore.Executive.ConnectionCredentials
Connected:False
EnableCompression:True
Id:8c9bba43-cc5d-4d7d-bbda-0282a8fb492f
Caption:ControllerProxy
ExtendedCaption:ControllerProxy
Internal:False
   

-------------- Example 3 Changes the address of the remote replication server --------------
Set-DcsReplicationPartnerGroupProperties -ReplicationPartnerServer SSV2 -RemoteUserName Administrator -RemotePassword PWXXXXXX01 -Address SSV1
		

A connection to the remote server group is made through the replication partner server named "SSV2". Credentials for SSV2 are supplied as "Administrator" as the user name and "PWXXXXXX01" as the password. The remote replication partner server is changed to "SSV1". The server "SSV1" will field communications from the local replication group.

GroupId:956be680-7c12-4c95-b54b-5219a20d1c44
HostAddresses:{SSV1}
IncomingCredentials:DataCore.Executive.ConnectionCredentials
OutgoingCredentials:DataCore.Executive.ConnectionCredentials
Connected:False
EnableCompression:True
Sequencenumber:12057
Id:e9657c2e-d289-4c35-8ae3-04fbed2a2343
Caption:ControllerProxy
ExtendedCaption:ControllerProxy
Internal:False