The New Send Connector process creates a new Send connector on a computer that has the Hub transport server role or the Edge transport server role installed. The following table describes the input parameters for New Send Connector process.
Adapter request parameters for New Send Connector process
| | |
|---|
| Required when the connector is linked to a Receive connector
If a linked Receive connector is specified by using the LinkedReceiveConnector parameter, the value of the AddressSpaces parameter must be Null.
Else, the AddressSpaces parameter specifies the domain names to which the Send connector sends messages.
The complete syntax for entering each address space is as follows: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost> - AddressSpaceType (On an Edge Transport server, the address space type must be SMTP. On a Hub Transport server, the address space type may be SMTP, X400, or a 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 entered 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. This parameter is optional. 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, 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".
If you specify a non-SMTP address space type on a Send connector that is configured on a Hub Transport server, the following settings are required on the Send connector:
You must use a smart host to route e-mail by specifying a value for the SmartHosts parameter.
You must set the DNSRoutingEnabled parameter to False. Although you can configure non-SMTP address spaces on a Send connector on a Hub Transport server, the Send connector uses SMTP as the transport mechanism to send messages to other messaging servers. Foreign connectors on Hub Transport servers are used to send messages to local messaging servers, such as third-party fax gateway servers, which don't use SMTP as their primary transport mechanism.
| |
| Specifies the administrator-supplied name of the connector
You must enclose the Name parameter in double quotation marks if the name contains spaces as follows, for example: New Send Connector. | |
| Used to write comments
You must enclose the Comment parameter in double quotation marks as follows, for example: "this is an admin note". | |
<ConnectionInactivityTimeOut> | Specifies the maximum time that an idle connection can remain open
The default value is 10 minutes. To specify a value, enter the value as a time span:dd.hh:mm:ss, where d = days, h = hours, m = minutes, and s = seconds. The valid input range for this parameter is 00:00:01 to 1.00:00:00. | |
| Specifies the Custom usage type
The usage type specifies the permissions and authentication methods that are assigned to the Send connector. If you use the Custom parameter, you can't use any of the following parameters: - Internal
- Internet
- Partner
- Usage
For more information about Send connector usage types, permissions, and authentication methods, see Send Connectors.
| |
| Enables the DNS routing Valid values for the DnsRoutingEnabled parameter are True or False. The default value is True. If you specify a SmartHosts parameter, the DnsRoutingEnabled parameter must be False on the same command line. | |
| Specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service
The DomainController parameter on the command should be included. 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. | |
| Enables mutual Transport Layer Security (TLS) authentication for the domains that are serviced by this Send connector Mutual TLS authentication will function correctly only if the following conditions are true: - The value of the DomainSecureEnabled parameter is set to True.
- The value of the DNSRoutingEnabled parameter is set to True.
The value of the IgnoreStartTLS parameter is set to False. The wildcard character is not supported in domains that are configured for mutual TLS authentication. The same domain must also be defined on the corresponding Receive connector, and in the value of the TLSReceiveDomainSecureList parameter in the Get-TransportConfig cmdlet.
The default value for DomainSecureEnabled is False for the following types of Send connectors: - All Send connectors that are defined on a Hub Transport server
- User-created Send connectors that are defined on a Edge Transport server.
The default value for DomainSecureEnabled is True for the following types of Send Connectors:
- Default Send connectors that are defined on an Edge Transport server
| |
| Enables or disables the ability for the connector to process e-mail messages Valid values for this parameter are True or False. The default value is True. | |
| Suppresses the warning or confirmation messages that appear during specific configuration changes | |
| Forcibly sends the value HELO Valid values for this parameter are True or False.
The default value is False. By default, EHLO is used. If this parameter is set to True, HELO will be sent instead of EHLO. | |
| Specifies the FQDN that is used as the source server for connected messaging servers that use the Send connector to receive outgoing messages
The value of this parameter is displayed to connected messaging servers whenever a source server name is required, as in the following examples: - In the EHLO/HELO command, when the Send connector communicates with the next hop messaging server
- In the most recent Received: header field of the message that is added to the message by the next hop messaging server after the message leaves the Hub Transport server or Edge Transport server
- During TLS authentication, the default value of the Fqdn parameter is Null. This means the actual default FQDN value is the FQDN of the Hub Transport server or Edge Transport server that contains the Send connector.
| |
| Specifies whether to ignore the StartTLS option that is offered by a remote sending server
This parameter is used with remote domains. This parameter must be set to False if the RequireTLS parameter is set to True. The valid values for this parameter are True and False. | |
| Specifies the Internal usage type
The usage type specifies the permissions and authentication methods that are assigned to the Send connector. If you use the Internal parameter, you can't use any of the following parameters: - Custom
- Internet
- Partner
- Usage
| |
| This parameter specifies the Internet usage type
The usage type specifies the permissions and authentication methods that are assigned to the Send connector. If you use the Internet parameter, you can't use any of the following parameters: - Custom
- Internal
- Partner
- Usage
| |
| 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. | |
| Forces all messages that are received by the specified Receive connector out through this Send connector
The value of LinkedReceivedConnector can use any of the following identifiers to specify the Receive connector: - GUID
- Distinguished name (DN)
- Servername\ConnectorName
When you use the LinkReceiveConnector parameter with the New SendConnector, you must also use the following parameters with the specified values: - DNSRoutingEnabled False
- MaxMessageSize unlimited
- Smarthosts <SmarthostID>
- SmarthostAuthMechanism <AuthMechanism>
When you use the LinkedReceiveConnector parameter, you must not use the AddressSpace parameter.
| |
| Specifies the maximum size of a message that can pass through a connector
The default value is 10MB. When you enter a value, qualify the value with one of the following units: - B (bytes)
- KB (kilobytes)
- MB (megabytes)
- GB (gigabytes)
Unqualified values are treated as bytes. Values that are entered in bytes are rounded up to nearest kilobyte. For example, 1048575B is rounded up to 1MB, and 1048577 is rounded up to 1025KB. The valid input range for this parameter is 0 to 2147483647 bytes. To remove the message size limit on a Send connector, enter a value of unlimited.
| |
| Specifies the Partner usage type
The usage type specifies the permissions and authentication methods that are assigned to the Send connector. If you use the Partner parameter, you can't use any of the following parameters: - Custom
- Internal
- Internet
- Usage
| |
| Specifies the port The valid input range for this parameter is an integer between 0 and 65535.
The default value is 25. If you specify a value in the SmartHosts parameter, the Port value specifies the port number that is used for smart host forwarding. In most organizations, the port number is set to 25. | |
| Enables or disables protocol logging for the specified Send connector
A value of Verbose enables protocol logging for the connector. A value of None disables protocol logging for the connector. | |
| Specifies whether all messages that are sent through this connector must be transmitted by using TLS
The default value is False. | |
| Used during authentication with a remote server
This parameter is used only when a smart host is configured and the DNSRoutingEnabled parameter is set to False. Valid values are None, BasicAuth, BasicAuthRequireTLS, ExchangeServer, and ExternalAuthoritative. All values are mutually exclusive. If you select BasicAuth or BasicAuthRequireTLS, you must use the AuthenticationCredential parameter to specify the authentication credential. | |
| Required if you set the DnsRoutingEnabled parameter to False and must be specified on the same command line
The SmartHosts parameter takes one or more FQDNs, such as server.contoso.com, or one or more IP addresses, or a combination of both
FQDNs and IP addresses.
Separate each value by using a comma. If you enter an IP address, you must enter the IP address as a literal as follows, for example: 10.10.1.1. The smart host identity can be the FQDN of a smart host server, a mail exchange (MX) record, or an address (A) record. If you configure an FQDN as the smart host identity, the source server for the Send connector must be able to use DNS name resolution to locate the smart host server. | |
| Specifies the local IP address to use as the endpoint for an SMTP connection to a remote messaging server. The
default IP address is 0.0.0.0.
This value tells the server to use any available local IP address. This parameter is only valid for Send connectors that are configured on Edge Transport servers. | |
| Specifies the names of the Hub Transport servers that can use this Send connector. You can specify the names of more than one Hub Transport server by separating the names with commas. This parameter is not valid for Send connectors that are configured on Edge Transport servers. | |
| Uses the configuration of that object to create an identical copy of the object on a local or target server, when an existing object is supplied to this parameter. | |
| Specifies the default permissions and authentication methods that are assigned to the Send connector
The valid values for this parameter are as follows: Custom, Internal, Internet, or Partner. If you don't specify a value for the Usage parameter, the usage type defaults to Custom. If you use the Usage parameter, you can't use any of the following parameters: - Custom
- Internal
- Internet
- Partner
| |
<UseExternalDNSServersEnabled> | Specifies whether this Send connector should use the external Domain Name System (DNS) list that is specified by using the ExternalDNSServers parameter of the Set-TransportServer cmdlet
The default value is False. The valid values of this parameter are True and False. | |