通过

New-ReceiveConnector (RTM)

  • 项目

 

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

上一次修改主题： 2007-07-23

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

语法

New-ReceiveConnector -Name <String> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-Server <ServerIdParameter>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internet | Internal | Client | Partner>]

详细说明

New-ReceiveConnector cmdlet 用于新建接收连接器。若要提示新接收连接器所必需的参数，请键入 New-ReceiveConnector。Name、Bindings 和 RemoteIPRanges 参数是新接收连接器所必需的参数。

完成此任务之后，将创建一个接收连接器。

若要运行 New-ReceiveConnector cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

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

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

参数

参数 必需 类型 说明

Name

必需

System.String

此参数指定管理员提供的连接器的名称。按如下所示以字符串形式输入 Name 参数，例如：New Receive Connector"。 "New Receive Connector".

AuthMechanism

可选

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

此参数指定公布的和已接受的身份验证机制。身份验证选项为 None、TLS、Integrated、BasicAuth、BasicAuthRequireTLS、ExchangeServer 和 ExternalAuthoritative。可以为 AuthMechanism 参数输入多个值，使用逗号分隔各个值。如果 RequireTLS 参数设置为 $true，则 AuthMechanism 参数必须设置为 TLS。如果 AuthMechanism 参数设置为 BasicAuthRequireTLS，还必须选择 BasicAuth 和 TLS。AuthMechanism 参数值 ExternalAuthoritative 只能与值 TLS 共存。如果将 AuthMechanism 参数设置为 ExternaAuthoritative，则 PermissionGroups 参数必须还要包含值 ExchangeServers。

Banner

可选

System.String

此参数将覆盖默认的简单邮件传输协议 (SMTP) 220 标题。如果 Banner 参数值为空，则默认的 SMTP 标题如下：

220 <Servername> Microsoft ESMTP MAIL service ready at <RegionalDay-Date-24HourTimeFormat> <RegionalTimeZoneOffset>

指定 Banner 参数值时，必须使用以下语法：

"220 <RemainingBannerText>".

220 是 RFC 2821 中定义的默认的“服务就绪”SMTP 响应代码。

BinaryMimeEnabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $True。如果 BinaryMimeEnabled 参数设置为 $True，BINARYMIME EHLO 关键字将在对远程服务器的 EHLO 响应中公布，并可供使用。如果 BinaryMimeEnabled 参数设置为 $False，BINARYMIME EHLO 关键字将不在对远程服务器的 EHLO 响应中公布并被禁用。

Bindings

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定接收连接器用于侦听入站邮件的本地 IP 地址和 TCP 端口号。此参数的有效语法为 <IP 地址>:<TCP 端口>，例如 192.168.1.1:25。IP 地址 0.0.0.0 表示接收连接器将使用所有网络适配器上配置的所有 IP 地址来侦听入站邮件。

note注意：
必须指定对接收连接器所在的集线器传输服务器或边缘传输服务器有效的本地 IP 地址。如果指定的本地 IP 地址无效，Microsoft Exchange 传输服务在重新启动时可能无法启动。若要指定所有网络适配器上配置的所有 IP 地址，可以使用 IP 地址 0.0.0.0。

使用 Bindings 参数指定的值必须满足下列唯一性要求之一：

  • 可以指定唯一的 IP 地址和 TCP 端口的组合，不与服务器上其他接收连接器的 Bindings 参数中使用的 IP 地址或 TCP 端口冲突。

  • 可以使用现有的 IP 地址和 TCP 端口的组合，但是使用 RemoteIPRanges 参数限制接收连接器处理的远程服务器。

为 Usage 参数指定下列值时，必须指定 Bindings 参数的值：

  • Internet

  • Custom

ChunkingEnabled

可选

System.Boolean

此参数的有效输入为 $True 或 $False。默认值为 $True。如果 ChunkingEnabled 参数设置为 $True，CHUNKING EHLO 关键字将在对远程服务器的 EHLO 响应中公布，并可供使用。如果 ChunkingEnabled 参数设置为 $False，CHUNKING EHLO 关键字将不在对远程服务器的 EHLO 响应中公布并被禁用。

Comment

可选

System.String

必须为 Comment 参数加上双引号，如下例所示： "this is an admin note".

ConnectionInactivityTimeout

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

此参数指定在关闭与接收连接器的连接之前的最大空闲时间量。在集线器传输服务器上配置的接收连接器的默认值为 5 分钟。在边缘传输服务器上配置的接收连接器的默认值为 1 分钟。若要指定值，请输入一个时间跨度：dd.hh:mm:ss，其中，d = 天数，h = 小时数，m = 分钟数，s = 秒数。ConnectionTimeout 参数指定的值必须大于 ConnectionInactivityTimeout 参数指定的值。任一参数的有效输入范围为 00:00:01 至 1.00:00:00。

ConnectionTimeOut

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

此参数指定某个连接可保持打开状态（即使该连接正在主动传输数据）的最长时间。在集线器传输服务器上配置的接收连接器的默认值为 10 分钟。在边缘传输服务器上配置的接收连接器的默认值为 5 分钟。若要指定值，请输入一个时间跨度：dd.hh:mm:ss，其中，d = 天数，h = 小时数，m = 分钟数，s = 秒数。ConnectionTimeout 参数指定的值必须大于 ConnectionInactivityTimeout 参数指定的值。任一参数的有效输入范围为 00:00:01 至 1.00:00:00。

DefaultDomain

可选

Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter

在没有提供域名的情况下，此参数所指定的域名将附加到通过发送服务器向邮件信封中的 MAIL FROM: 或 RCPT TO: 提交的值。

DeliveryStatusNotificationEnabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $True。如果 DeliveryStatusNotificationEnabled 参数设置为 $True，DSN EHLO 关键字将在对远程服务器的 EHLO 响应中公布，并可供使用。如果 DeliveryStatusNotificationEnabled 参数设置为 $False，DSN EHLO 关键字将不在对远程服务器的 EHLO 响应中公布并被禁用。对 ESMTP 的 DSN 扩展提供了在 RFC 1891 中指定的增强发送状态通知功能。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

DomainSecureEnabled

可选

System.Boolean

此参数是对此接收连接器处理的域启用相互 TLS 身份验证的过程的第一部分。只有满足下列条件，才能正常进行相互 TLS 身份验证：

  • DomainSecureEnabled 参数值为 $True。

  • AuthMechanism 参数包含值 TLS，并且不包含值 ExternalAuthoritative。

  • AuthMechanism 参数值包含 TLS。

  • Get-TransportConfig cmdlet 中的 TLSReceiveDomainSecureList 参数至少包含一个由此接收连接器处理的域。为相互 TLS 身份验证配置的域不支持通配符 (*)。还必须在相应的发送连接器上以及在 Get-TransportConfig cmdlet 的 TLSSendDomainSecureList 参数值中定义相同的域。

对于下列类型的接收连接器，DomainSecureEnabled 的默认值为 $False：

  • 在集线器传输服务器上定义的所有接收连接器。

  • 在边缘传输服务器上定义的用户创建的接收连接器。

对于在边缘传输服务器上定义的默认接收连接器，DomainSecureEnabled 的默认值为 $True。

EightBitMimeEnabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $True。如果 EightBitMimeEnabled 参数设置为 $True，8BITMIME EHLO 关键字将在对远程服务器的 EHLO 响应中公布，并可供使用。如果 EightBitMimeEnabled 参数设置为 $False，8BITMIME EHLO 关键字将不在对远程服务器的 EHLO 响应中公布并被禁用。

Enabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $True。使用 Enabled 参数启用或禁用连接器。

EnhancedStatusCodesEnabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $True。如果 EnhancedStatusCodesEnabled 参数设置为 $True，ENHANCEDSTATUSCODES EHLO 关键字将在对远程服务器的 EHLO 响应中公布，并可供使用。如果 EnhancedStatusCodesEnabled 参数设置为 $False，ENHANCEDSTATUSCODES EHLO 关键字将不在对远程服务器的 EHLO 响应中公布并被禁用。ENHANCEDSTATUSCODES 扩展提供发送到远程服务器的发送状态通知 (DSN) 中增强的错误和状态信息。

Fqdn

可选

Microsoft.Exchange.Data.Fqdn

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

  • 在接收连接器的默认 SMTP 标题中

  • 在接收连接器的 EHLO/HELO 响应中

  • 传入邮件进入集线器传输服务器或边缘传输服务器时，在最新的 Received: 邮件头字段中

  • 在传输层安全性 (TLS) 身份验证期间

Fqdn 参数的默认值是包含接收连接器的集线器传输服务器或边缘传输服务器的 FQDN。

note注意：
不要在集线器传输服务器上自动创建的默认接收连接器（名为“Default <Server Name>”）上修改 FQDN 值。如果 Exchange 组织中有多台集线器传输服务器，并且在“Default <Server Name>”接收连接器上更改了 FQDN 值，集线器传输服务器之间的内部邮件流将失败。

MaxHeaderSize

可选

Microsoft.Exchange.Data.ByteQuantifiedSize

此参数指定接收连接器在关闭连接之前所接受的 SMTP 邮件头的最大大小（以字节为单位）。默认值为 65536 个字节。输入值时，请使用下列单位之一限定值：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

未限定的值被视为以字节为单位。此参数的有效输入范围为 1 至 2147483647 个字节。

MaxHopCount

可选

System.Int32

此参数指定在接收连接器拒绝邮件之前，该邮件可经过的最大跃点数。默认值为 30。此参数的有效输入范围为 1 至 500。

注意   最大跃点数由已提交的邮件中的 Received: 标题字段数确定。

MaxInboundConnection

可选

Microsoft.Exchange.Data.Unlimited

此参数指定此接收连接器同时处理的最大入站连接数。默认值为 5000。此参数的有效输入范围为 1 至 2147483647。若要在接收连接器上禁用入站连接限制，请输入值 unlimited。

MaxInboundConnectionPercentagePerSource

可选

System.Int32

此参数指定接收连接器同时处理的来自一个 IP 地址的最大连接数，以接收连接器上可用剩余连接的百分比表示。输入不带百分比 (%) 字符的整数值。默认值为 2%。此参数的有效输入范围为 1 至 100。

MaxInboundConnectionPerSource

可选

Microsoft.Exchange.Data.Unlimited

此参数指定此接收连接器同时处理的来自一个 IP 地址的最大连接数。默认值为 100。此参数的有效输入范围为 1 至 10000。若要在接收连接器上禁用每个源的入站连接限制，请输入值 unlimited。

MaxLocalHopCount

可选

System.Int32

此参数指定在接收连接器拒绝邮件之前，该邮件可经过的最大本地跃点数。默认值为 3。此参数的有效输入范围为 0 至 50。如果指定值 0，则永远不会基于本地跃点数拒绝邮件。

note注意：
最大本地跃点数由已提交邮件中具有本地服务器地址的“已接收:”标题的数量确定。

MaxLogonFailures

可选

System.Int32

此参数指定接收连接器在关闭连接之前重试登录的失败次数。默认值为 3。此参数的有效输入范围为 0 至 10。如果指定值 0，则永远不会因为登录失败而关闭连接。

MaxMessageSize

可选

Microsoft.Exchange.Data.ByteQuantifiedSize

此参数指定邮件的最大大小。默认值为 10 MB。输入值时，请使用下列单位之一限定值：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

未限定的值被视为以字节为单位。此参数的有效输入范围为 1 至 2147483647 字节。

MaxProtocolErrors

可选

Microsoft.Exchange.Data.Unlimited

此参数指定接收连接器在关闭连接之前接受的最大 SMTP 协议错误数。默认值为 5。此参数的有效输入范围为 0 至 2147483647。如果指定值 unlimited，则永远不会因为协议错误而关闭连接。

MaxRecipientsPerMessage

可选

System.Int32

此参数指定接收连接器在关闭连接之前接受的每封邮件的最大收件人数。默认值为 200。此参数的有效输入范围为 1 至 512000。

MessageRateLimit

可选

Microsoft.Exchange.Data.Unlimited

此参数指定单个客户端 IP 地址每分钟可发送的最大邮件数。在集线器传输服务器上配置的接收连接器的默认值为 unlimited。在边缘传输服务器上配置的接收连接器的默认值为每分钟 600 封邮件。此参数的有效输入范围为 1 至 2147483647。若要在接收连接器上取消邮件速率限制，请输入值 unlimited。

PermissionGroups

可选

Microsoft.Exchange.Data.PermissionGroups

此参数定义可将邮件提交给接收连接器的组或角色以及为这些组分配的权限。权限组是为已知安全主体授予的一组预定义权限。此参数的有效值如下：None、AnonymousUsers、ExchangeUsers、ExchangeServers、ExchangeLegacyServers 和 Partners。为接收连接器分配的默认权限组取决于在创建接收连接器时通过 Usage 参数指定的连接器使用类型。有关接收连接器使用类型的详细信息，请参阅接收连接器。

PipeliningEnabled

可选

System.Boolean

此参数的有效值为 $True 或 $False。如果 PipeliningEnabled 参数设置为 $True，PIPELINING EHLO 关键字将在对远程服务器的 EHLO 响应中公布，并可供使用。如果 PipeliningEnabled 参数设置为 $False，PIPELINING EHLO 关键字将不在对远程服务器的 EHLO 响应中公布并被禁用。PIPELINING 扩展使远程服务器不必等待此接收连接器的响应即可发送请求。默认值为 $True。

ProtocolLoggingLevel

可选

Microsoft.Exchange.Data.ProtocolLoggingLevel

此参数对指定接收连接器启用或禁用协议日志记录。Verbose 值将对连接器启用协议日志记录。None 值将对连接器禁用协议日志记录。默认值为 None。使用 Set-TransportServer cmdlet 的 ReceiveProtocolLogPath 参数，可以指定在集线器传输服务器或边缘传输服务器上配置的所有接收连接器的协议日志位置。

RemoteIPRanges

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定此连接器从其接受邮件的远程 IP 地址。此参数的有效语法为 <起始 IP 地址>-<结束 IP 地址>，例如 192.168.1.1-192.168.1.10。可以指定多个 IP 地址范围，使用逗号分隔范围。

为 Usage 参数指定下列值时，必须指定 RemoteIPRanges 参数的值：

  • Internal

  • Custom

只要一个 IP 地址范围与另一个 IP 地址范围完全重叠，同一台服务器上的多个接收连接器就会有重叠的远程 IP 地址范围。当远程 IP 地址范围重叠时，将使用与正在连接服务器的 IP 地址最匹配的远程 IP 地址范围。

RequireEHLODomain

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $False。如果 RequireEHLODomain 参数设置为 $True，远程计算机在建立 SMTP 连接之后，必须在 EHLO 握手中提供域名。如果远程计算机没有提供域名，则 SMTP 连接将关闭。

RequireTLS

可选

System.Boolean

此参数的有效值为 $True 或 $False。默认值为 $False。如果 RequireTLs 参数设置为 $True，此连接器接收的所有邮件都需要进行传输层安全性 (TLS) 传输。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

此参数指定应在其上新建接收连接器的服务器。

SizeEnabled

可选

Microsoft.Exchange.Data.SizeMode

此参数的有效值为 Enabled、Disabled 或 EnabledwithoutValue。默认值为 Enabled。如果 SizeEnabled 参数设置为 Enabled，将启用 SIZE SMTP 扩展，MaxMessageSize 参数设置的允许的最大邮件大小值将在 EHLO 标题中公布。如果 SizeEnabled 参数设置为 Disabled，则不使用 SIZE SMTP 扩展，并且永远不会将允许的最大邮件大小值透露给远程服务器。如果 SizeEnabled 参数设置为 EnabledWithoutValue，将启用 SIZE SMTP 扩展。但是，MaxMessageSize 参数设置的允许的最大邮件大小值不会在 EHLO 标题中公布。这样，对于集线器传输服务器之间经过身份验证的连接，邮件可以绕过邮件大小检查。SIZE SMTP 扩展在 RFC 1870 中定义。SIZE 使源服务器可以向目标服务器声明入站邮件的大小。还使目标服务器可以向发送服务器声明允许接受的最大邮件大小。如果公布的入站邮件大小超过 MessageSizeMax 参数的值，则接收连接器通过使用错误代码向远程服务器作出响应，并关闭连接。

TarpitInterval

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

此参数指定延迟向 Exchange 确定可能会滥用连接的远程服务器作出 SMTP 响应的时间。经过身份验证的连接从不会发生此类延迟。

默认值为 5 秒。若要指定值，请输入一个时间跨度：dd.hh:mm:ss，其中，d = 天数，h = 小时数，m = 分钟数，s = 秒数。此参数的有效输入范围为 00:00:00 至 00:10:00。如果将值设置为 00:00:00，将禁用缓送间隔。

TemplateInstance

可选

System.Management.Automation.PSObject

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

Usage

可选

Microsoft.Exchange.Management.SystemConfigurationTasks.NewReceiveConnector+UsageType

此参数指定为此接收连接器分配的默认权限组和身份验证方法。Usage 参数的有效值如下：Client、Custom、Internal、Internet 和 Partner。

如果为 Usage 参数指定下列任一值，必须为 Bindings 参数指定值：

  • Internet

  • Custom

如果为 Usage 参数指定下列任一值，必须为 RemoteIPRanges 参数指定值：

  • Internal

  • Custom

如果未指定必需的参数值，命令将以失败告终。New-ReceiveConnector cmdlet 不会提示您提供缺少的必需参数。

有关接收连接器使用类型、权限组和身份验证方法的详细信息，请参阅接收连接器。

输入类型

返回类型

错误

错误 说明

 

 

示例

New-ReceiveConnector 命令可新建接收连接器。此示例显示创建接收连接器所必需的最少参数。

note注意：
无法创建多个共享相同 Bindings 参数和 RemoteIPRanges 参数的接收连接器。 
New-ReceiveConnector -Name Test -Bindings 10.10.1.1:25 -RemoteIPRanges 192.168.0.1-192.168.0.24