Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Topic Last Modified: 2007-11-26

This topic explains how to use the Exchange Management Shell to modify an existing Foreign connector for Microsoft Exchange Server 2007.

A Foreign connector can only be installed on an Exchange 2007 computer that has the Hub Transport server role installed. A Foreign connector uses a Drop directory to send messages to a local messaging server that does not use the Simple Mail Transfer Protocol (SMTP) as its primary transport mechanism.

Before You Begin

To perform the following procedures, the account you use must be delegated the following:

  • Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Note:
You cannot modify the configuration of a Foreign connector by using the Exchange Management Console. To modify the configuration of a Foreign connector, you must use the Exchange Management Shell. For more information about how to use the Exchange Management Shell, see Using the Exchange Management Shell.

Using the Exchange Management Shell to Modify an Existing Foreign Connector

You can use the Set-ForeignConnector cmdlet to modify all available settings for an existing Foreign connector. The Identity parameter specifies the Foreign connector that you want to modify. The Identity parameter can be the GUID or the name of the Foreign connector.

The values that you specify by using the Set-ForeignConnector cmdlet replace the existing values that are configured on the Send connector. To preserve any existing values in a multivalued parameter, you must specify the existing value and any new values that you want to add when you run the Set-SendConnector cmdlet.

The command in the following procedure is an example of how to use the Exchange Management Shell to make the following changes to settings on an existing Foreign connector named "Contoso.com Foreign Connector":

  • Change the maximum message size that is allowed on the connector to 50 MB.

  • Add a new address space for the SMTP domain named Contoso.com that has an address space cost of 5. You want to preserve the existing X.400 address space o=MySite;p=MyOrg;a=contoso;c=us that has an address space cost of 1 that is already configured on the connector.

To use the Exchange Management Shell to modify the existing Foreign connector named "Contoso.com Foreign Connector"

  • Run the following command:

    Copy Code
    Set-ForeignConnector "Contoso.com Foreign Connector" -AddressSpaces "X400:o=MySite;p=MyOrg;a=contoso;c=us;1","contoso.com;5" -MaxMessageSize 50MB
    

For more information about how to retrieve the identity of a Foreign connector, see How to View the Configuration of a Foreign Connector.

For detailed syntax and configuration information, see Set-ForeignConnector.

For More Information

For more information, see Foreign Connectors.