Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Topic Last Modified: 2007-01-02

This topic explains how to use the Exchange Management Shell to modify the status of an existing Foreign connector for a computer that has the Microsoft Exchange Server 2007 Hub Transport server role installed.

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. A Foreign connector must be enabled for it to send messages. Disable a Foreign connector to stop sending messages by using the configuration that is represented by that connector. By default, when you create a Foreign connector, it is enabled.

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 enable or disable Foreign connector by using the Exchange Management Console. To enable or disable 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 Enable or Disable a Foreign Connector

You can use the Set-ForeignConnector cmdlet to enable or disable a Foreign connector. The Identity parameter specifies the Foreign connector that you want to enable or disable. The Identity parameter can be the GUID or the name of the Foreign connector. If you want enable or disable all the Foreign connectors in the Exchange organization at the same time, you must pipe the results of the Get-ForeignConnector cmdlet to the Set-ForeignConnector cmdlet.

To use the Exchange Management Shell to modify the status of a Foreign connector

  • To disable one Foreign connector, run the following command:

    Copy Code
    Set-ForeignConnector <Identity> -Enabled <$True | $False>
    

    For example , to disable a Foreign connector named "Contoso.com Foreign Connector", run the following command:

    Copy Code
    Set-ForeignConnector "Contoso.com Foreign Connector" -Enabled $False
    
  • To disable all Foreign connectors in the Exchange organization, run the following command:

    Copy Code
    Get-ForeignConnector | Set-ForeignConnector -Enabled $False
    

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

For more information about pipelining, see Pipelining.

For more information about how to work with the information that a command returns, see Working with Command Output.

For More Information

For more information, see Foreign Connectors.