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

Use the New-ForeignConnector cmdlet to create a new 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

New-ForeignConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IsScopedConnector <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

AddressSpaces

Required

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies the domain names to which the Foreign connector sends messages. The complete syntax for entering each address space is as follows: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   The address space type may be SMTP, X400, or any other text string. If you omit the address space type, an SMTP address space type is assumed.

  • AddressSpace   For SMTP address space types, the address space that you enter must be RFC 1035-compliant. For example, *, *.com, and *.contoso.com are permitted, but *contoso.com is not permitted. For X.400 address space types, the address space that you enter must be RFC 1685-compliant, such as o=MySite;p=MyOrg;a=adatum;c=us. For all other values of address type, you can enter any text for the address space.

  • AddressSpaceCost   The valid input range for the cost is 1 to 100. A lower cost indicates a better route. If you omit the address space cost, a cost of 1 is assumed. If you enter a non-SMTP address space that contains the semicolon character ( ; ), you must specify the address space cost.

If you specify the address space type or the address space cost, you must enclose the address space in double quotation marks ( " ). For example, the following address space entries are equivalent:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

You may specify multiple address spaces by separating the address spaces with commas, as follows, for example: contoso.com,fabrikam.com. If you specify the address space type or the address space cost, you must enclose the address space in double quotation marks ( " ) as follows, for example: "contoso.com;2","fabrikam.com;3".

Name

Required

System.String

This parameter specifies a name for the Foreign connector.

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. The DomainController parameter is not supported on computers that run the Edge Transport server role. The Edge Transport server role reads and writes only to the local ADAM instance.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter.

IsScopedConnector

Optional

System.Boolean

This parameter controls the availability of the connector to other Hub Transport servers. When the value of this parameter is $False, the connector can be used by all Hub Transport servers in the Exchange organization. When the value of this parameter is $True, the connector can only be used by Hub Transport servers in the same Active Directory site. The default value is $False.

SourceTransportServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies the names of the Hub Transport servers that use this Foreign connector. You may specify multiple Hub Transport servers by separating the server names with commas. Having a single Foreign connector homed on multiple Hub Transport servers provides fault tolerance and high availability if one of the Hub Transport servers fails. The default value of this parameter is the name of the Hub Transport server on which this Foreign connector was first installed.

TemplateInstance

Optional

System.Management.Automation.PSObject

When an existing object is supplied to this parameter, the cmdlet uses the configuration of that object to create a copy of the object.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter.

Detailed Description

The New-ForeignConnector cmdlet creates a new Foreign connector. To be prompted for the required parameters of a new Foreign connector, enter New-ForeignConnector. After this task is completed, a Foreign connector is created.

Note:
After you create a new Foreign connector, you must restart the Microsoft Exchange Transport service (MSExchangeTransport) for the changes to take effect.

To run the New-ForeignConnector cmdlet, the account you use must be delegated the Exchange Server Administrator role and local Administrators group for the target server.

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

Example

The following code example shows a New-ForeignConnector command that creates a new Foreign connector with the following properties:

  • Connector name: Contoso Foreign Connector

  • Address space: "Contoso.com"

  • Address space type: SMTP

  • Address space cost: 5

  • Source Transport Servers: Hub01 and Hub02

Copy Code
New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "SMTP:*.contoso.com;5" -SourceTransportServers "Hub01,Hub02"