Set-ReceiveConnector
适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题: 2009-08-19
使用 Set-ReceiveConnector cmdlet 可以在安装了边缘传输服务器角色或集线器传输服务器角色的计算机上修改现有接收连接器。
语法
Set-ReceiveConnector -Identity <ReceiveConnectorIdParameter> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]]
详细说明
Set-ReceiveConnector cmdlet 修改现有接收连接器。运行 Set-ReceiveConnector cmdlet 时 Identity 为必需参数。
完成此任务以后,接收连接器得到修改。
若要运行 Set-ReceiveConnector cmdlet,必须向您使用的帐户委派下列角色:
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
若要在安装了边缘传输服务器角色的计算机上运行 Set-ReceiveConnector cmdlet,必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。
有关权限、角色委派以及管理 Microsoft Exchange Server 2007 所需权限的详细信息,请参阅权限注意事项。
参数
参数 | 必需 | 类型 | 说明 | ||
---|---|---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
此参数指定 GUID 或表示接收连接器的连接器名称。Identity 标签可以省略。 |
||
AuthMechanism |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector+AuthMechanisms |
此参数指定公布的和已接受的身份验证机制。身份验证选项为 |
||
Banner |
可选 |
System.String |
此参数将覆盖默认的简单邮件传输协议 (SMTP) 220 标题。如果 Banner 参数值为空,则默认的 SMTP 标题如下:
指定 Banner 参数值时,必须使用以下语法:
220 是 RFC 2821 中定义的默认的“服务就绪”SMTP 响应代码。 |
||
BinaryMimeEnabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
Bindings |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
此参数指定了接收连接器用于侦听入站邮件的本地 IP 地址和 TCP 端口号。此参数的有效语法是 <IP 地址>:<TCP 端口>,如
使用 Bindings 参数指定的值必须满足下列要求之一来保持唯一性:
|
||
ChunkingEnabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
注释 |
可选 |
System.String |
必须为 Comment 参数加上双引号,如下例所示: |
||
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。 |
||
ConnectionInactivityTimeout |
可选 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
此参数指定在关闭对接收连接器的连接之前的最大空闲时间量。在集线器传输服务器上配置的接收连接器的默认值为 5 分钟。在边缘传输服务器上配置的接收连接器的默认值为 1 分钟。若要指定值,请输入一个时间跨度:dd.hh:mm:ss,其中,d = 天数,h = 小时数,m = 分钟数,s = 秒数。ConnectionTimeout 参数指定的值必须大于 ConnectionInactivityTimeout 参数指定的值。任一参数的有效输入范围为 |
||
ConnectionTimeOut |
可选 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
此参数指定某个连接可保持开启状态(即使该连接正在传输数据)的最长时间。在集线器传输服务器上配置的接收连接器的默认值为 10 分钟。在边缘传输服务器上配置的接收连接器的默认值为 5 分钟。若要指定值,请输入一个时间跨度:dd.hh:mm:ss,其中,d = 天数,h = 小时数,m = 分钟数,s = 秒数。ConnectionTimeout 参数指定的值必须大于 ConnectionInactivityTimeout 参数指定的值。任一参数的有效输入范围为 |
||
DefaultDomain |
可选 |
Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter |
在没有提供域名的情况下,此参数所指定的域名将附加到通过发送服务器向邮件信封中的 |
||
DeliveryStatusNotificationEnabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色将只读取和写入本地 ADAM 实例。 |
||
DomainSecureEnabled |
可选 |
System.Boolean |
此参数是对由此接收连接器提供服务的域启用相互 TLS 身份验证的过程的第一部分。只有满足下列条件,才能正常进行相互 TLS 身份验证:
对于下列类型的接收连接器,DomainSecureEnabled 的默认值为
对于在边缘传输服务器上定义的默认接收连接器,DomainSecureEnabled 的默认值为 |
||
EightBitMimeEnabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
EnableAuthGSSAPI |
可选 |
System.Boolean |
当此连接器上启用集成 Windows 身份验证时,此参数控制通用安全服务应用程序编程接口 (GSSAPI) 身份验证方法的通知。如果 AuthMechanism 参数包含 如果您拥有对此接收连接器进行身份验证的 Microsoft Internet Information Services (IIS) 邮件服务器,则应将 EnableAuthGSSAPI 参数的值设置为 此参数的有效输入范围为 |
||
Enabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
EnhancedStatusCodesEnabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
Fqdn |
可选 |
Microsoft.Exchange.Data.Fqdn |
此参数指定 FQDN,该域名用作使用接收连接器发送传入邮件的连接的邮件服务器的目标服务器。每当需要目标服务器名称时,就会向连接的邮件服务器显示此参数的值,如以下示例所示:
Fqdn 参数的默认值是包含接收连接器的集线器传输服务器或边缘传输服务器的 FQDN。
|
||
Instance |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
使用此参数,可将整个对象传递给此命令进行处理。该参数主要用于必须将整个对象传递给命令的脚本。 |
||
LongAddressesEnabled |
可选 |
System.Boolean |
此参数使接收连接器能够接受长 X.400 电子邮件地址。X.400 电子邮件地址使用 Internet Mail Connector Encapsulated Address (IMCEA) 封装方法封装在 SMTP 电子邮件地址中。 当此参数的值为 当此参数的值为
因此,X.400 电子邮件地址在经过 IMCEA 封装后可长达 1860 个字符。 此参数的有效输入范围为 |
||
MaxHeaderSize |
可选 |
Microsoft.Exchange.Data.ByteQuantifiedSize |
此参数指定接收连接器在关闭连接之前所接受的 SMTP 邮件头的最大大小(以字节为单位)。默认值为
未限定的值被视为以字节为单位。此参数的有效输入范围为 |
||
MaxHopCount |
可选 |
System.Int32 |
此参数指定在接收连接器拒绝一封邮件之前该邮件可经过的最大跃点数。最大跃点数由已提交邮件中的 |
||
MaxInboundConnection |
可选 |
Microsoft.Exchange.Data.Unlimited |
MaxInboundConnection 参数指定此接收连接器同时处理的入站连接的最大数量。默认值为 |
||
MaxInboundConnectionPercentagePerSource |
可选 |
System.Int32 |
此参数指定接收连接器从单个 IP 地址同时处理的连接的最大数目。该值以接收连接器上的可用剩余连接百分比表示。输入不带有百分比 (%) 字符的整数值。默认值为 2%。此参数的有效输入范围为 |
||
MaxInboundConnectionPerSource |
可选 |
Microsoft.Exchange.Data.Unlimited |
此参数指定此接收连接器从单个 IP 地址同时处理的最大入站连接数。默认值为 |
||
MaxLocalHopCount |
可选 |
System.Int32 |
此参数指定在接收连接器拒绝一封邮件之前该邮件可经过的最大跃点数。最大本地跃点数由已提交邮件中具有本地服务器地址的
|
||
MaxLogonFailures |
可选 |
System.Int32 |
此参数指定接收连接器在关闭连接之前重试登录的失败次数。默认值为 |
||
MaxMessageSize |
可选 |
Microsoft.Exchange.Data.ByteQuantifiedSize |
此参数指定邮件的最大大小。默认值为
未限定的整数被视为以字节为单位。此参数的有效输入范围是 65536 至 2147483647 字节。 |
||
MaxProtocolErrors |
可选 |
Microsoft.Exchange.Data.Unlimited |
此参数指定接收连接器在关闭连接之前接受的 SMTP 协议错误的最大数目。默认值为 |
||
MaxRecipientsPerMessage |
可选 |
System.Int32 |
MaxRecipientsPerMessage 参数指定接收连接器在关闭连接之前接受的每个邮件的收件人的最大数量。默认值为 |
||
MessageRateLimit |
可选 |
Microsoft.Exchange.Data.Unlimited |
此参数指定每分钟单个客户端 IP 地址可发送邮件的最大数量。在集线器传输服务器上配置的接收连接器的默认值为 |
||
名称 |
可选 |
System.String |
此参数指定管理员提供的连接器的名称。按如下所示以字符串形式输入 Name 参数,例如: |
||
OrarEnabled |
可选 |
System.Boolean |
此参数可启用 Originator Requested Alternate Recipient (ORAR)。此参数的值为 此参数的有效输入范围为 |
||
PermissionGroups |
可选 |
Microsoft.Exchange.Data.PermissionGroups |
此参数定义可将邮件提交给接收连接器的组或角色以及分配给这些组的权限。权限组是为已知安全主体授予的一组预定义权限。此参数的有效值如下: |
||
PipeliningEnabled |
可选 |
System.Boolean |
此参数的有效值为 |
||
ProtocolLoggingLevel |
可选 |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
此参数对指定接收连接器启用或禁用协议日志记录。 |
||
RemoteIPRanges |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
此参数指定此连接器从中接受邮件的远程 IP 地址。此参数的有效语法是 <起始 IP 地址>-<结束 IP 地址>,如 只要一个 IP 地址范围与另一个 IP 地址完全重叠,同一服务器上的多个接收连接器就会有重叠的远程 IP 地址范围。当远程 IP 地址范围重叠时,将使用与连接服务器的 IP 地址最匹配的远程 IP 地址范围。 |
||
RequireEHLODomain |
可选 |
System.Boolean |
此参数的有效值为 |
||
RequireTLS |
可选 |
System.Boolean |
此参数的有效值为 |
||
SizeEnabled |
可选 |
Microsoft.Exchange.Data.SizeMode |
此参数的有效值为 |
||
TarpitInterval |
可选 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
TarpitInterval 参数指定延迟向远程服务器作出 SMTP 响应的时间段,其中远程服务器由 Exchange 确定并可能滥用连接。经过身份验证的连接从不以此方式延迟。默认值为 5 秒。若要指定值,请输入一个时间跨度:hh:mm:ss,其中 h = 小时,m = 分钟,s = 秒。此参数的有效输入范围为 |
||
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,您可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
|
|
示例
Set-ReceiveConnector 命令的以下示例将 Banner 参数设置为 "220 Banner Text here"
,将 ConnectionTimeOut 参数设置为 00:15:00
。
Set-ReceiveConnector -Identity "Internet Receive Connector" -Banner "220 Banner Text here" -ConnectionTimeout 00:15:00