Set-RoutingGroupConnector (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
Use the Set-RoutingGroupConnector cmdlet to modify the properties of an existing routing group connector between a Microsoft Exchange Server 2007 routing group and an Exchange Server 2003 or Exchange 2000 Server routing group.
Syntax
Set-RoutingGroupConnector -Identity <RoutingGroupConnectorIdParameter> [-Cost <Int32>] [-DomainController <Fqdn>] [-Name <String>] [-PublicFolderReferralsEnabled <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-TargetTransportServers <MultiValuedProperty>]
Set-RoutingGroupConnector [-Cost <Int32>] [-DomainController <Fqdn>] [-Instance <RoutingGroupConnector>] [-Name <String>] [-PublicFolderReferralsEnabled <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-TargetTransportServers <MultiValuedProperty>]
Detailed Description
Use the Set-RoutingGroupConnector cmdlet to modify the properties of an existing routing group connector. A routing group connector is used to send and receive messages between Exchange 2007 Hub Transport servers and Exchange Server 2003 or Exchange 2000 Server bridgehead servers when the organization is running more than one version of Exchange.
If you use this cmdlet to set a source server or target server, the cmdlet overwrites existing entries. The Exchange Server 2003 and Exchange 2000 Server source servers that are specified in this cmdlet are automatically added to the ExchangeLegacyInterop Universal Security Group. By default, the Exchange 2007 system grants Send to and Receive from permissions on the Hub Transport servers to the members of this group. The source and target servers must be computers that have the Exchange 2007 Hub Transport server role installed, or Exchange Server 2003 or Exchange 2000 Server bridgehead servers.
To run the Set-RoutingGroupConnector cmdlet, the account you use must be delegated the following:
- Exchange Server Administrator role and local Administrators group for the target server
For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.RoutingGroupConnectorIdParameter |
Use the Identity parameter to specify the name or the GUID of the routing group connector. The name is expressed as [[Administrative Group Name\]Routing Group Name]\Routing Group Connector Name. |
Cost |
Optional |
System.Int32 |
Use the Cost parameter to assign a cost to the connector. Transport servers use the connector cost to determine the least cost routing path from a source server to the destination server for message delivery. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Use the DomainController parameter to specify the host name or fully qualified domain name (FQDN) of the domain controller that this command will bind to and that will write this change to the Active Directory directory service. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RoutingGroupConnector |
Use the Instance parameter to pass a complete object to the command to be processed. It is mainly used in scripts where a complete object must be passed to the command. |
Name |
Optional |
System.String |
Use the Name parameter to modify the name of the routing group connector. |
PublicFolderReferralsEnabled |
Optional |
System.Boolean |
Use the PublicFolderReferralsEnabled parameter to specify whether users can use this routing group connector to access a public folder replica that is located in the routing group of the target servers when an instance of that public folder is not available in the same routing group as the user's mailbox. The default value is |
SourceTransportServers |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Use the SourceTransportServers parameter to specify the host name or FQDN of the transport servers that will be used to send messages to the target transport servers. You can specify more than one server by separating each entry with a comma. |
TargetTransportServers |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Use the TargetTransportServers parameter to specify the host name or FQDN of the transport servers that will receive messages from the source transport servers. You can specify more than one server by separating each entry with a comma. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
This example uses the Set-RoutingGroupConnector cmdlet to modify the cost of a routing group connector. The command also overwrites the source server and target server for the connector.
Set-RoutingGroupConnector -Identity "Exchange Administrative Group (FYDIBOHF23SPDLT)\Exchange Routing Group (DWBGZMFD01QNBJR)\Ex2007 to 2003 RGC" -Cost 70 -SourceTransportServers 2007Hub1.contoso.com -TargetTransportServers 2003BH1.contoso.com