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.
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.
|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.
Set-ForeignConnector "Contoso.com Foreign Connector" -Enabled $False
This example enables the same Foreign connector.
Set-ForeignConnector "Contoso.com Foreign Connector" -Enabled $True
This example disables all Foreign connectors in your organization.
Get-ForeignConnector | Set-ForeignConnector -Enabled $False
For detailed syntax and parameter information, see Set-ForeignConnector.