Share via

New-SendConnector (RTM)

  • 项目

 

适用于： Exchange Server 2007 SP1, Exchange Server 2007

上一次修改主题： 2007-08-27

使用 New-SendConnector cmdlet 可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上新建发送连接器。

语法

New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-MaxMessageSize <Unlimited>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>]

New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>]

详细说明

此 cmdlet 可新建发送连接器。若要提示新发送连接器的必需参数，请输入 New-SendConnector。完成此任务之后，即创建了一个发送连接器。

若要运行 New-SendConnector cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组。

若要在安装了边缘传输服务器角色的计算机上运行 New-SendConnector cmdlet，必须使用作为该计算机的本地 Administrators 组成员的帐户进行登录。

有关权限、角色委派以及管理 Microsoft Exchange Server 2007 所需权限的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

AddressSpaces

必需

Microsoft.Exchange.Data.MultiValuedProperty

除非使用 LinkedReceiveConnector 参数将此连接器链接到接收连接器，否则，此参数是必需的。AddressSpaces 参数指定发送连接器向其发送邮件的域名。可以指定多个地址空间，使用逗号分隔地址空间。输入每个地址空间的完整语法如下：

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   如果指定值 Local，则只有与要运行 New-SendConnector cmdlet 的源集线器传输服务器位于同一个 Active Directory 站点的其他集线器传输服务器可以使用该连接器。如果省略 ConnectorScope 限定符，则整个 Exchange 2007 组织中的所有集线器传输服务器都可以使用该连接器。

  • AddressSpaceType   在边缘传输服务器上，地址空间类型必须是 SMTP。在集线器传输服务器上，地址空间类型可以是 SMTP、X400 或任何其他文本字符串。如果省略地址空间类型，则假定是 SMTP 地址空间类型。

  • AddressSpace   对于 SMTP 地址空间类型，您输入的地址空间必须符合 RFC 1035 标准。例如，允许输入 *、*.com 和 *.contoso.com，但是不允许输入 *contoso.com。对于 X.400 地址空间类型，您输入的地址空间必须符合 RFC 1685 标准，例如 o=MySite;p=MyOrg;a=adatum;c=us。对于地址类型的所有其他值，可以为地址空间输入任何文本。

  • AddressSpaceCost   开销的有效输入范围是 1 到 100。开销越低表示路由越好。此参数是可选的。如果省略地址空间开销，则假设开销是 1。如果输入包含分号字符 ( ; ) 的非 SMTP 地址空间，则必须指定地址空间开销。

只有在下列情况下才必须使用 AddressSpaces 参数的完整语法：

  • 具有 Local 限定符的定域连接器

  • 非 SMTP 地址空间

  • 开销不是 1 的 SMTP 地址空间

可以指定多个地址空间，使用逗号分隔地址空间，例如：contoso.com,fabrikam.com。如果指定连接器作用域、地址空间类型或地址空间开销，必须为地址空间加上双引号 ( " )，例如："contoso.com;2","fabrikam.com;3"。 "contoso.com;2","fabrikam.com;3".

如果在集线器传输服务器上配置的发送连接器上指定非 SMTP 地址空间类型，需要在发送连接器上进行下列设置：

  • 必须通过指定 SmartHosts 参数的值，使用智能主机路由电子邮件。

  • 必须将 DNSRoutingEnabled 参数设置为 $False。

note注意：
尽管可以在集线器传输服务器上的发送连接器上配置非 SMTP 地址空间，但是，发送连接器将使用 SMTP 作为传输机制，将邮件发送到其他邮件服务器。使用集线器传输服务器上的外部连接器将邮件发送到不使用 SMTP 作为其主要传输机制的本地邮件服务器，例如第三方传真网关服务器。有关详细信息，请参阅外部连接器。

Name

必需

System.String

此参数是管理员提供的连接器的名称。如果名称包含空格，则必须为 Name 参数加上双引号，如下例所示： "New Send Connector".

AuthenticationCredential

可选

System.Management.Automation.PSCredential

此参数需要创建并传递凭据对象。此凭据对象是通过使用 Get-Credential cmdlet 创建的。有关 Get-Credential cmdlet 的详细信息，请在 Exchange 命令行管理程序中键入 Get-Help Get-Credential。

Comment

可选

System.String

必须将 Comment 参数放在双引号中，如下例所示： "this is an admin note".

ConnectionInactivityTimeOut

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

此参数指定空闲连接可以保持打开状态的最长时间。默认值为 10 分钟。若要指定值，请输入一个时间跨度：dd.hh:mm:ss，其中，d = 天数，h = 小时数，m = 分钟数，s = 秒数。此参数的有效输入范围为 00:00:01 至 1.00:00:00。

DNSRoutingEnabled

可选

System.Boolean

DnsRoutingEnabled 参数的有效值是 $True 或 $False。默认值为 $True。如果指定了 SmartHosts 参数，则同一命令行上的 DnsRoutingEnabled 参数必须为 $False。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色将只读取和写入本地 ADAM 实例。

DomainSecureEnabled

可选

System.Boolean

此参数是对由此发送连接器提供服务的域启用相互传输层安全性 (TLS) 身份验证的过程的一部分。只有满足下列条件，才能正常进行相互 TLS 身份验证：

  • DomainSecureEnabled 参数的值设置为 $True。

  • DNSRoutingEnabled 参数的值设置为 $True。

  • IgnoreStartTLS 参数的值设置为 $False。

为相互 TLS 身份验证配置的域不支持通配符 (*)。还必须在相应的接收连接器上定义相同的域，并在 Get-TransportConfig cmdlet 的 TLSReceiveDomainSecureList 参数值中定义相同的域。

对于下列类型的发送连接器，DomainSecureEnabled 的默认值是 $False：

  • 集线器传输服务器上定义的所有发送连接器

  • 边缘传输服务器上定义的用户创建的发送连接器

对于下列类型的发送连接器，DomainSecureEnabled 的默认值是 $True：

  • 边缘传输服务器上定义的默认发送连接器

Enabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $True。使用 Enabled 参数可以启用或禁用连接器处理电子邮件的能力。

Force

可选

System.Management.Automation.SwitchParameter

此参数禁止在特定配置更改过程中显示警告消息或确认消息。

ForceHELO

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $False。默认情况下，使用 EHLO。如果此参数设置为 $True，则将发送 HELO 而不是 EHLO。

Fqdn

可选

Microsoft.Exchange.Data.Fqdn

此参数指定对于已连接的使用发送连接器接收传出邮件的邮件服务器，作为其源服务器使用的 FQDN。只要要求提供源服务器名称，就会向已连接的邮件服务器显示此参数的值，如以下示例所述：

  • 发送连接器与下一个跃点的邮件服务器进行通信时，在 EHLO/HELO 命令中

  • 邮件传出集线器传输服务器或边缘传输服务器之后，在下一个跃点的邮件服务器向邮件添加的最新的 Received: 邮件头字段中

  • 在 TLS 身份验证期间

Fqdn 参数的默认值为 $Null。这意味着，实际的默认 FQDN 值是包含发送连接器的集线器传输服务器或边缘传输服务器的 FQDN。

note注意：
如果在安装了邮箱服务器角色的集线器传输服务器上配置发送连接器，则不会使用您为 Fqdn 参数指定的任何值。将始终使用通过 Get-ExchangeServer cmdlet 显示服务器的 FQDN。
对于同时安装了集线器传输服务器角色和邮箱服务器角色的服务器，将服务器名称从传出邮件的 Received: 头中删除的唯一方式是，使用 Remove-ADPermission cmdlet 将 Ms-Exch-Send-Headers-Routing 权限从使用该连接器的安全主体中删除。此操作会在邮件传出集线器传输服务器时，将所有 Received: 头从邮件中删除。建议您不要删除内部邮件的 Received: 头，因为需要使用 Received: 头计算最大跃点数。有关 Remove-ADPermission cmdlet 和 Get-ExchangeServer cmdlet 的详细信息，请参阅下列主题：
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

可选

System.Boolean

此参数指定是否忽略由远程发送服务器提供的 StartTLS 选项。此参数与远程域一起使用。如果将 RequireTLS 参数设置为 $True，则必须将此参数设置为 $False。此参数的有效值是 $True 和 $False。

LinkedReceiveConnector

可选

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

此参数将强制所有由指定接收连接器接收的邮件通过此发送连接器发出。LinkedReceivedConnector 的值可使用以下任一标识符指定接收连接器：

  • GUID

  • 可分辨名称 (DN)

  • 服务器名称\连接器名称

使用带有 LinkReceiveConnector 参数的 New-SendConnector cmdlet 时，还必须使用下列具有指定值的参数：

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

如果使用 LinkedReceiveConnector 参数，就不能使用 AddressSpace 参数。

MaxMessageSize

可选

Microsoft.Exchange.Data.Unlimited

MaxMessageSize 值指定通过连接器传递的邮件的最大大小。如果不想对此连接器应用邮件限制，还可以通过输入 unlimited 来重载此参数。默认值为 10MB。输入整数时，请使用下列单位之一限定值：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

未限定的值被视为以字节为单位。以字节为单位输入的值将向上舍入为最接近的千字节。例如，1048575B 将向上舍入为 1MB，1048577 将向上舍入为 1025KB。此参数的有效输入范围为 0 到 2147483647 字节。

Port

可选

System.Int32

此参数的有效输入范围是 0 到 65535 之间的整数。默认值为 25。如果指定 SmartHosts 参数的值，则 Port 值指定用于进行智能主机转发的端口号。在大多数组织中，端口号被设置为 25。

ProtocolLoggingLevel

可选

Microsoft.Exchange.Data.ProtocolLoggingLevel

此参数对指定发送连接器启用或禁用协议日志记录。Verbose 值将对连接器启用协议日志记录。None 值将对连接器禁用协议日志记录。集线器传输服务器或边缘传输服务器上配置的所有发送连接器的发送连接器协议日志位置，都使用 Set-TransportServer cmdlet 的 SendProtocolLogPath 参数指定。

RequireTLS

可选

System.Boolean

此参数指定通过此连接器发送的所有邮件是否都必须使用 TLS 进行传输。默认值为 $False。

SmartHostAuthMechanism

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

在向远程服务器进行身份验证期间，需要使用此参数。仅当配置了智能主机并将 DNSRoutingEnabled 参数设置为 $False 时，才使用此参数。有效值是 None、BasicAuth、BasicAuthRequireTLS、ExchangeServer 和 ExternalAuthoritative。所有值均相互排斥。如果选择 BasicAuth 或 BasicAuthRequireTLS，则必须使用 AuthenticationCredential 参数指定身份验证凭据。

SmartHosts

可选

Microsoft.Exchange.Data.MultiValuedProperty

如果将 DnsRoutingEnabled 参数设置为 $False，则必须使用此参数，并且必须在同一命令行上指定。SmartHosts 参数接受一个或多个 FQDN（例如 server.contoso.com）、一个或多个 IP 地址或者 FQDN 和 IP 地址的组合。每个值使用逗号分隔。如果输入 IP 地址，则必须逐个数字地输入 IP 地址，如下例所示：10.10.1.1。智能主机标识可以是智能主机服务器的 FQDN、邮件交换 (MX) 记录或地址 (A) 记录。如果将 FQDN 配置为智能主机标识，发送连接器的源服务器必须能够使用 DNS 名称解析来定位智能主机服务器。

SourceIPAddress

可选

System.Net.IPAddress

此参数指定用作指向远程邮件服务器的 SMTP 连接终结点的本地 IP 地址。默认 IP 地址是 0.0.0.0。此值将告诉服务器使用任何可用的本地 IP 地址。此参数仅对在边缘传输服务器上配置的发送连接器有效。

SourceTransportServers

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定可以使用此发送连接器的集线器传输服务器的名称。可以指定多个集线器传输服务器的名称，使用逗号分隔名称。此参数对在边缘传输服务器上配置的发送连接器无效。

TemplateInstance

可选

System.Management.Automation.PSObject

将现有对象提供给此参数时，命令将使用该对象的配置在本地服务器或目标服务器上创建对象的相同副本。

Usage

可选

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

此参数有助于根据连接器的使用方式来配置连接器的默认值。此参数的有效值如下：Custom、Internal、Internet 或 Partner。有关发送连接器使用选项的详细信息，请参阅 发送连接器。

UseExternalDNSServersEnabled

可选

System.Boolean

此参数指定此发送连接器是否应当使用外部域名系统 (DNS) 列表，该列表使用 Set-TransportServer cmdlet 的 ExternalDNSServers 参数指定。默认值为 $False。此参数的有效值是 $True 和 $False。

输入类型

返回类型

错误

错误 说明

 

 

示例

第一个示例显示用于新建通过 Internet 发送电子邮件的发送连接器的命令。该示例显示创建发送连接器所必需的最少参数。地址空间限制为只向 Contoso.com 域和 Microsoft.com 域发送邮件。

第二个示例显示用于新建向 Contoso.com 发送电子邮件的发送连接器的命令。Contoso.com 电子邮件服务器要求本地 Exchange 2007 服务器通过其身份验证才能提交电子邮件。若要将发送连接器配置为使用身份验证，必须首先运行 Get-Credential 命令，并将该命令赋予一个变量。运行 Get-Credential 命令时，该命令将要求输入向 Contoso.com 电子邮件服务器进行身份验证期间使用的帐户的用户名和密码。

在第二个示例中，Get-Credential cmdlet 被赋予 $CredentialObject 变量。身份验证凭据被赋予 $CredentialObject 变量之后，可以使用 New-SendConnector cmdlet 来新建发送连接器。$CredentialObject 变量被传递给 AuthenticationCredential 参数。除了设置凭据之外，还必须将 SmartHostAuthMechanism 参数设置为 BasicAuth，以便指示发送连接器使用提供的凭据向 Contoso.com 电子邮件服务器进行身份验证。

New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth