Get-ForeignConnector

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-ForeignConnector cmdlet to view the configuration information for a Foreign connector on a computer that is running Microsoft Exchange Server 2007 and that has the Hub Transport server role installed. A Foreign connector uses a Drop directory on a Hub Transport server to send messages to a local messaging server that doesn't use the Simple Mail Transfer Protocol (SMTP) as its primary transport mechanism. These messaging servers are known as foreign gateway servers. Third-party fax gateway servers are examples of foreign gateway servers. The address spaces that are assigned to a Foreign connector can be SMTP or non-SMTP.

Syntax

Get-ForeignConnector [-Identity <ForeignConnectorIdParameter>] [-DomainController <Fqdn>]

Detailed Description

The Get-ForeignConnector cmdlet retrieves the configuration information for a Foreign connector. You can use the Identity parameter to retrieve the configuration information for a specific Foreign connector. To retrieve the configuration information for all Foreign connectors, do not include the Identity parameter in the command.

To run the Get-ForeignConnector cmdlet, the account you use must be delegated the Exchange View-Only Administrators role.

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

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

This parameter specifies the Foreign connector that you want to examine. The Identity parameter can take any of the following values for the Foreign connector object:

  • GUID

  • Connector name

  • ServerName\ConnectorName

Example

The following code sample shows two examples that use the Get-ForeignConnector cmdlet.

The first example displays a summary list of all Foreign connectors on all Hub Transport servers.

The second example shows how to view the detailed configuration of a specific Foreign connector by piping the results of the Get-ForeignConnector cmdlet to the Format-List cmdlet.

For more information about pipelining, see Pipelining.

For more information about how to work with the output of a cmdlet, see Working with Command Output.

Get-ForeignConnector
Get-ForeignConnector "Foreign Connector Name" | Format-List