Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2011-04-28

You can use the Shell to enable or disable an existing Foreign connector for Microsoft Exchange Server 2010. A Foreign connector can only be installed on a computer running Exchange 2010 that has the Hub Transport server role installed. A Foreign connector uses a Drop directory to send messages to a local messaging server that doesn't use SMTP as its primary transport mechanism.

Looking for other management tasks related to managing connectors? Check out Managing Connectors.

Prerequisites

You must have an existing Foreign connector. For detailed steps about creating a Foreign connector, see Create a Foreign Connector.

Use the Shell to enable or disable a Foreign connector

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Foreign connectors" entry in the Transport Permissions topic.

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.

Note:
You can't enable or disable a Foreign connector by using the Exchange Management Console. To enable or disable a Foreign connector, you must use the Shell. For more information about how to use the Shell, see Exchange Management Shell.

This example disables the Foreign connector Contoso.com Foreign Connector.

Copy Code
Set-ForeignConnector "Contoso.com Foreign Connector" -Enabled $False

This example enables the same Foreign connector.

Copy Code
Set-ForeignConnector "Contoso.com Foreign Connector" -Enabled $True

This example disables all Foreign connectors in your organization.

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

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