New-SendConnector

  • 项目

 

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

上一次修改主题： 2007-09-05

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

语法

New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-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>] [-WhatIf [<SwitchParameter>]]

New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-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>] [-WhatIf [<SwitchParameter>]]

详细说明

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

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

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

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

参数

参数 必需 类型 说明

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 作为其主要传输机制的本地邮件服务器，例如第三方传真网关服务器。有关详细信息，请参阅外部连接器。

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".

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。

Custom

可选

System.Management.Automation.SwitchParameter

此参数指定 Custom 使用类型。使用类型指定为发送连接器分配的权限和身份验证方法。如果使用 Custom 参数，则不能使用下列任何参数：

  • Internal

  • Internet

  • Partner

  • Usage

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

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

IgnoreSTARTTLS

可选

System.Boolean

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

Internal

可选

System.Management.Automation.SwitchParameter

此参数指定 Internal 使用类型。使用类型指定为发送连接器分配的权限和身份验证方法。如果使用 Internal 参数，则不能使用下列任何参数：

  • Custom

  • Internet

  • Partner

  • Usage

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

Internet

可选

System.Management.Automation.SwitchParameter

此参数指定 Internet 使用类型。使用类型指定为发送连接器分配的权限和身份验证方法。如果使用 Internet 参数，则不能使用下列任何参数：

  • Custom

  • Internal

  • Partner

  • Usage

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

IsScopedConnector

可选

System.Boolean

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

此参数指定可以通过连接器传递的邮件的最大大小。默认值为 10MB。输入值时，请使用下列单位之一限定值：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

未限定的值被视为以字节为单位。以字节为单位输入的值将向上舍入为最接近的千字节。例如，1048575B 将向上舍入为 1MB，1048577 将向上舍入为 1025KB。此参数的有效输入范围为 0 到 2147483647字节。若要取消发送连接器上的邮件大小限制，请输入 unlimited 值。

Partner

可选

System.Management.Automation.SwitchParameter

此参数指定 Partner 使用类型。使用类型指定为发送连接器分配的权限和身份验证方法。如果使用了 Partner 参数，则不能使用下列任一参数：

  • Custom

  • Internal

  • Internet

  • Usage

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

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。如果不指定 Usage 参数的值，默认使用类型为 Custom。

如果使用 Usage 参数，则不能使用下列任何参数：

  • Custom

  • Internal

  • Internet

  • Partner

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

UseExternalDNSServersEnabled

可选

System.Boolean

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

WhatIf

可选

System.Management.Automation.SwitchParameter

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

输入类型

返回类型

错误

错误 说明

 

 

示例

第一个示例显示用于新建通过 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