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