Set-SendConnector (RTM)

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

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

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

语法

Set-SendConnector -Identity <SendConnectorIdParameter> [-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>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Set-SendConnector [-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>] [-Instance <SmtpSendConnectorConfig>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

详细说明

Set-SendConnector cmdlet 用于修改现有发送连接器。运行 Set-SendConnector cmdlet 时，Name 参数是必需的。仅当修改 Name 参数值时，Identity 参数才是必需的。

完成此任务之后，将修改发送连接器。

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

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

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

参数

参数	必需	类型	说明
Identity	必需	Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter	Identity 参数用于指定表示要修改的发送连接器的 GUID 或连接器名称。
AddressSpaces	可选	Microsoft.Exchange.Data.MultiValuedProperty	除非将此连接器链接到接收连接器，否则，此参数是必需的。如果使用 LinkedReceiveConnector 参数指定链接的接收连接器，AddressSpaces 值必须为 $null。否则，AddressSpaces 参数将指定发送连接器向其发送邮件的域名。可以指定多个地址空间，使用逗号分隔地址空间。输入每个地址空间的完整语法如下： <ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost> ConnectorScope   如果指定值 Local，则只有与要运行 New-SendConnector cmdlet 的源集线器传输服务器位于同一个 Active Directory 站点的其他集线器传输服务器可以使用该连接器。如果省略 ConnectorScope 限定符，则整个 Exchange 2007 组织中的所有集线器传输服务器都可以使用该连接器。 AddressSpaceType   对于 SMTP 地址空间，此值必须是 SMTP。对于非 SMTP 地址空间，此值可以是任意描述性文本字符串，例如“Lotus Notes”。 AddressSpace   对于 SMTP 地址空间，可以使用 RFC 1035 中定义的域名系统 (DNS) 通配符 (*)。例如，可以使用“*”、“*.com”或“*.contoso.com”。对于非 SMTP 地址空间，可以使用通配符 (*) 以及其他字符，例如“*contoso.com”或“@contoso”。 AddressSpaceCost   开销的有效输入范围是 1 到 100。开销越低表示路由越好。此参数是可选的。如果在使用完整语法输入地址空间时省略 AddressSpaceCost 限定符，则假定开销为 1。 只有在下列情况下才需要使用 AddressSpaces 参数的完整语法： 具有 Local 限定符的定域连接器 非 SMTP 地址空间 开销不是 1 的 SMTP 地址空间 如果输入域名或逗号分隔的域名列表作为 AddressSpaces 参数的值，则假定每个域名的地址空间类型是 SMTP，开销是 1。在边缘传输服务器上配置的发送连接器只支持 SMTP 地址空间。在集线器传输服务器上配置的发送连接器支持 SMTP 地址空间和非 SMTP 地址空间。
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	此参数指定是否应当使用域名系统 (DNS) 路由，或者，是否所有邮件都应当通过使用 SmartHosts 参数配置的智能主机进行发送。默认值为 $True。如果要将值设置为 $False，则必须先为 SmartHosts 参数设置值。
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。 注意： 如果在安装了邮箱服务器角色的集线器传输服务器上配置发送连接器，则不会使用您为 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	此参数的有效输入为 $True 或 $False。此参数指定是否忽略由远程发送服务器提供的 StartTLS 选项。此参数与远程域一起使用。如果将 RequireTLS 参数设置为 $True，则必须将此参数设置为 $False。默认情况下，DNSRoutingEnabled 参数值设置为 $True 的发送连接器也会将 IgnoreStartTLS 参数的值设置为 $False。这意味着如果由接收服务器提供 TLS，则发送连接器会始终协商 TLS。如果将 IgnoreStartTLS 参数的值设置为 $True，则发送连接器永远不会尝试与接收服务器协商 TLS。
Instance	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig	使用此参数可以将整个对象传递给此命令进行处理。该参数主要用于必须将整个对象传递给命令的脚本。
LinkedReceiveConnector	可选	Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter	此参数将强制所有由指定接收连接器接收的邮件通过此发送连接器发出。LinkedReceivedConnector 的值可使用以下任一标识符指定接收连接器： GUID 可分辨名称 (DN) 服务器名称\连接器名称 在 Set-SendConnector cmdlet 中使用 LinkReceiveConnector 参数时，必须还要使用具有指定值的下列参数： AddressSpaces $null DNSRoutingEnabled $False MaxMessageSize unlimited Smarthosts <SmarthostID> SmarthostAuthMechanism <AuthMechanism>
MaxMessageSize	可选	Microsoft.Exchange.Data.Unlimited	此参数指定可以通过连接器传递的邮件的最大大小。默认值为 10MB。输入值时，请使用下列单位之一限定值： B（字节） KB（千字节） MB（兆字节） GB（千兆字节） 未限定的值被视为以字节为单位。此参数的有效输入范围为 0 到 2147483647 字节。若要取消发送连接器上的邮件大小限制，请输入 unlimited 值。
Name	可选	System.String	Name 参数是由管理员提供的连接器的名称。如果名称包含空格，则必须为 Name 参数加上双引号，如下例所示： "New Send Connector".
Port	可选	System.Int32	此参数的有效输入范围是 0 到 65535 之间的整数。默认值为 25。如果指定 SmartHosts 参数的值，则 Port 值指定用于进行智能主机转发的端口号。在大多数组织中，端口号被设置为 25。
ProtocolLoggingLevel	可选	Microsoft.Exchange.Data.ProtocolLoggingLevel	此参数对指定发送连接器启用或禁用协议日志记录。如果值为 Verbose，将对连接器启用协议日志记录。如果值为 None，将对连接器禁用协议日志记录。默认值为 None。在集线器传输服务器或边缘传输服务器上配置的所有发送连接器的发送连接器协议日志文件位置使用 Set-TransportServer 命令的 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	此参数接受一个或多个 FQDN（例如，server.contoso.com），或一个或多个逗号分隔的 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	此参数指定可以使用此发送连接器的集线器传输服务器的名称。可以指定多个集线器传输服务器的名称，使用逗号分隔名称。此参数对在边缘传输服务器上配置的发送连接器无效。
UseExternalDNSServersEnabled	可选	System.Boolean	此参数指定此发送连接器是否应当使用外部 DNS 列表，该列表使用 Set-TransportServer cmdlet 的 ExternalDNSServers 参数指定。默认值为 $False。此参数的有效值是 $True 和 $False。

输入类型

返回类型

错误

示例

第一个代码示例显示修改现有发送连接器的 Set-SendConnector 命令。该命令将 MaxMessageSize 限制设置为 10 MB 并将 ConnectionInactivityTimeOut 设置为 15 分钟。

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

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

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth