通过

Set-SendConnector

  • 项目

 

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

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

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

语法

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

详细说明

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 参数将指定发送连接器向其发送邮件的域名。输入每个地址空间的完整语法如下：<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • 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 地址空间，则必须指定地址空间开销。

如果指定地址空间类型或地址空间开销，必须为地址空间加上双引号 ( " )。例如，下列地址空间条目是等效的：

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

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

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

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

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

note注意：
尽管可以在集线器传输服务器上的发送连接器上配置非 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".

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

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。

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
• Get-ExchangeServer

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

使用此参数，可将整个对象传递给此命令进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

IsScopedConnector

可选

System.Boolean

此参数控制连接到其他集线器传输服务器的连接器的可用性。此参数的值为 $False 时，Exchange 组织中的所有集线器传输服务器均可以使用该连接器。此参数的值为 $True 时，只有同一个 Active Directory 站点中的集线器传输服务器可以使用该连接器。默认值为 $False。

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（千兆字节）

未限定的值被视为以字节为单位。以字节为单位输入的值将向上舍入为最接近的千字节。例如，1048575B 将向上舍入为 1MB，1048577 将向上舍入为 1025KB。此参数的有效输入范围为 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。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

 

示例

第一个代码示例显示修改现有发送连接器的 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