Set-SendConnector

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Set-SendConnector cmdlet 修改发送连接器。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Set-SendConnector
   [-Identity] <SendConnectorIdParameter>
   [-AddressSpaces <MultiValuedProperty>]
   [-AuthenticationCredential <PSCredential>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectionInactivityTimeOut <EnhancedTimeSpan>]
   [-ConnectorType <TenantConnectorType>]
   [-DNSRoutingEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-DomainSecureEnabled <Boolean>]
   [-Enabled <Boolean>]
   [-ErrorPolicies <ErrorPolicies>]
   [-Force]
   [-ForceHELO <Boolean>]
   [-Fqdn <Fqdn>]
   [-FrontendProxyEnabled <Boolean>]
   [-IgnoreSTARTTLS <Boolean>]
   [-IsCoexistenceConnector <Boolean>]
   [-IsScopedConnector <Boolean>]
   [-LinkedReceiveConnector <ReceiveConnectorIdParameter>]
   [-MaxMessageSize <Unlimited>]
   [-Name <String>]
   [-Port <Int32>]
   [-ProtocolLoggingLevel <ProtocolLoggingLevel>]
   [-RequireOorg <Boolean>]
   [-RequireTLS <Boolean>]
   [-SmartHostAuthMechanism <AuthMechanisms>]
   [-SmartHosts <MultiValuedProperty>]
   [-SmtpMaxMessagesPerConnection <Int32>]
   [-SourceIPAddress <IPAddress>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-TlsAuthLevel <TlsAuthLevel>]
   [-TlsCertificateName <SmtpX509Identifier>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-UseExternalDNSServersEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

说明

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00

本示例对发送连接器 Contoso.com Send Connector 进行以下配置更改：

将最大邮件大小限制设置为 10 MB。
将连接不活动超时更改为 15 分钟。

参数

-AddressSpaces

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

如果指定非 SMTP 地址空间类型用于在邮箱服务器上的传输服务中配置的发送连接器，必须配置以下参数：

SmartHosts 参数必须设置为指定智能主机的值。
DNSRoutingEnabled 参数必须设置为 $false。

尽管可以在邮箱服务器上的传输服务中的发送连接器上配置非 SMTP 地址空间，但是，发送连接器将使用 SMTP 作为传输机制，将邮件发送到其他邮件服务器。邮箱服务器上的传输服务中的外部连接器用于将邮件发送到本地邮件服务器，例如非Microsoft传真网关服务器，这些服务器不使用 SMTP 作为主要传输机制。有关详细信息，请参阅外部连接器。

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AuthenticationCredential

AuthenticationCredential 参数指定使用连接器所需的用户名和密码。

此参数的值需要 Get-Credential cmdlet。要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。有关详细信息，请参阅 Get-Credential。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CloudServicesMailEnabled

注意：建议不要使用此参数，除非Microsoft客户服务和支持部门或特定产品文档指示你执行此作。请改用混合配置向导来配置本地和云组织之间的邮件流。有关详细信息，请参阅 "混合配置"向导。

CloudServicesMailEnabled 参数指定连接器是否用于本地 Exchange 环境与 Microsoft 365 之间的混合邮件流。具体而言，此参数控制在本地和云组织接受域之间发送的消息中如何处理某些内部 X-MS-Exchange-Organization-* 消息头。这些标头统称为跨界标头。

有效值包含:

$true：连接器用于混合组织中的邮件流，因此，在流经连接器的邮件中保留或提升跨界标头。这是混合配置向导创建的连接器的默认值。从混合组织的一端发送到另一端的出站邮件中的某些 X-MS-Exchange-Organization-* 标头将转换为 X-MS-Exchange-CrossPremises-* 标头，从而保留在邮件中。从混合组织的一端收到的入站邮件中的 X-MS-Exchange-CrossPremises-* 标头将提升为 X-MS-Exchange-Organization-* 标头。这些提升的标头替换邮件中已存在的同一 X-MS-Exchange-Organization-* 标头的任何实例。
$false：连接器不用于混合组织中的邮件流，因此将从流经连接器的邮件中删除任何跨界标头。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Comment

Comment 参数指定可选注释。必须使用引号 (") 括住 Comment 参数，例如： "this is an admin note".

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConnectionInactivityTimeOut

ConnectionInactivityTimeOut 参数指定空闲连接可以保持打开状态的最长时间。默认值为 10 分钟。

若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。

例如，要指定十五分钟，将其设置为 00:15:00。此参数的有效输入范围为 00:00:01 至 1.00:00:00。

类型:	EnhancedTimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConnectorType

ConnectorType 参数指定是否在混合部署中使用连接器将消息发送到 Microsoft 365。有效值包含:

默认值：连接器不用于将消息发送到 Microsoft 365。此值为默认值。
XPremises：连接器用于将消息发送到 Microsoft 365。

类型:	TenantConnectorType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DNSRoutingEnabled

DNSRoutingEnabled 参数指定发送连接器是否使用域名系统 (DNS) 路由邮件。此参数的有效值为 $true 或 $false。默认值为 $true。如果指定 SmartHosts 参数，DNSRoutingEnabled 参数必须为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainSecureEnabled

DomainSecureEnabled 参数是对由此发送连接器提供服务的域启用相互传输层安全性 (TLS) 身份验证的过程的一部分。只有满足下列条件，才能正常进行相互 TLS 身份验证：

DomainSecureEnabled 参数的值必须为 $true。
DNSRoutingEnabled 参数的值必须为 $true。
IgnoreStartTLS 参数的值必须为 $false。

为相互 TLS 身份验证配置的域不支持通配符 (*)。还必须在相应的接收连接器和传输配置的 TLSReceiveDomainSecureList 属性中定义相同的域。

对于下列类型的发送连接器，DomainSecureEnabled 参数的默认值为 $false：

在邮箱服务器上的传输服务中定义的所有发送连接器。
在边缘服务器上定义的用户创建的发送连接器。

对于在边缘服务器上定义的默认发送连接器，DomainSecureEnabled 参数的默认值为 $true。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Enabled

Enabled 参数指定是否启用连接器来处理电子邮件。有效值为$true或$false。默认值为 $true。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ErrorPolicies

ErrorPolicies 指定如何处理通信错误。可能的值如下：

默认值：针对通信错误生成未送达报告 (NDR) 。
DowngradeDnsFailures：所有 DNS 错误都被视为暂时性。
DowngradeCustomFailures：特定 SMTP 错误被视为暂时性错误。
UpgradeCustomFailures 自定义暂时性故障将升级并被视为永久性故障。

可以为此参数指定多个值，使用逗号分隔。

只有在使用此发送连接器通过可靠、定义明确的通信通道发送消息时（预期此通道不会出现通信错误），才能为此参数指定一个除 Default 之外的值。例如，如果此发送连接器用于将消息发送到某个合作伙伴，可以考虑指定一个除 Default 之外的值。

类型:	ErrorPolicies
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

强制开关隐藏警告或确认消息。不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceHELO

ForceHELO 参数指定是否发送 HELO 而不是默认的 EHLO。有效值为$true或$false。默认值为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Fqdn

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

发送连接器与下一个跃点的邮件服务器进行通信时，在 EHLO/HELO 命令中
邮件从邮箱服务器上或边缘服务器上的传输服务传出之后，在下一个约点的邮件服务器向邮件添加的最新的 Received 邮件头字段中
在 TLS 身份验证期间

Fqdn 参数的默认值是 $null。这意味着，默认 FQDN 值是包含发送连接器的邮箱服务器或边缘服务器的 FQDN。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FrontendProxyEnabled

FrontendProxyEnabled 参数通过 CAS 服务器路由出站邮件；当该参数设置为 $true 时，将设置特定于目标的路由，如 DNS 或 IP 地址。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Identity

表示要修改的发送连接器的 GUID 或连接器名称。

类型:	SendConnectorIdParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-IgnoreSTARTTLS

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsCoexistenceConnector

此参数仅在 Exchange Server 2010 中可用。

IsCoexistenceConnector 参数指定此发送连接器是否用于本地部署与 Microsoft 365 组织之间的安全邮件流。默认值为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsScopedConnector

IsScopedConnector 参数指定其他具有传输服务的邮箱服务器的连接器的可用性。当此参数的值$false时，Exchange 组织中的所有邮箱服务器都可以使用该连接器。当此参数的值$true时，连接器只能由同一 Active Directory 站点中的邮箱服务器上的传输服务使用。默认值为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LinkedReceiveConnector

此参数仅在 Exchange Server 2010 中可用。

LinkedReceiveConnector 参数强制指定接收连接器通过此发送连接器接收的所有消息。 LinkedReceiveConnector 参数的值可以使用以下任何标识符来指定接收连接器：

GUID
可分辨名称 (DN)
Servername\ConnectorName

将 LinkedReceiveConnector 参数与此命令一起使用时，还必须使用以下具有指定值的参数：

AddressSpaces $null
DNSRoutingEnabled $false
MaxMessageSize unlimited
Smarthosts <SmarthostID>
SmarthostAuthMechanism <AuthMechanism>

类型:	ReceiveConnectorIdParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxMessageSize

MaxMessageSize 参数指定可以通过连接器传递的邮件的最大大小。默认值为 25 MB。

有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。

B（字节）
KB（千字节）
MB（兆字节）
GB（千兆字节）
TB（兆兆字节）

TB（兆兆字节）

此参数的有效输入范围是 0 至 2147483647 字节。若要取消发送连接器上的邮件大小限制，请输入 unlimited 值。

类型:	Unlimited
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

Name 参数指定管理员提供的连接器的名称。如果名称包含空格，则必须为 Name 参数加上双引号 (")。例如，"New Send Connector"。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Port

如果在 Port 参数中指定了值，则 SmartHosts 参数指定智能主机转发的端口号。有效输入范围是从 0 到 65535 的整数。默认值是 25。在大多数组织中，端口号设置为 25。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProtocolLoggingLevel

ProtocolLoggingLevel 指定是否启用协议日志记录。 Verbose 启用协议日志记录。 None 禁用协议日志记录。邮箱服务器或边缘服务器上的传输服务中配置的所有发送连接器的发送连接器协议日志位置，都使用 Set-TransportService cmdlet 的 SendProtocolLogPath 参数指定。

类型:	ProtocolLoggingLevel
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequireOorg

保留此参数以供 Microsoft 内部使用。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequireTLS

RequireTLS 参数指定通过此连接器发送的所有邮件是否都必须使用 TLS 进行传输。默认值为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmartHostAuthMechanism

SmartHostAuthMechanism 参数指定在对远程服务器进行身份验证时使用的智能主机身份验证机制。只有当配置了智能主机，并将 DNSRoutingEnabled 参数设置为 $false 时，才使用此参数。有效值是 None、BasicAuth、BasicAuthRequireTLS、ExchangeServer 和 ExternalAuthoritative。所有值相互排斥。如果选择 BasicAuth 或 BasicAuthRequireTLS，则必须使用 AuthenticationCredential 参数指定身份验证凭据。

类型:	AuthMechanisms
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmartHosts

SmartHosts 参数指定发送连接器用于路由邮件的智能主机。如果将 DNSRoutingEnabled 参数设置为 $false并且必须在同一命令行上指定此参数，则此参数是必需的。 SmartHosts 参数接受一个或多个 FQDN（例如 server.contoso.com）、一个或多个 IP 地址或者 FQDN 和 IP 地址的组合。如果输入 IP 地址，则必须逐个数字地输入 IP 地址。例如，10.10.1.1。智能主机标识可以是智能主机服务器的 FQDN、邮件交换器 (MX) 记录或地址 (A) 记录。如果将 FQDN 配置为智能主机标识，发送连接器的源服务器必须能够使用 DNS 名称解析来定位智能主机服务器。

若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

要添加或移除一个或多个值而不影响任何现有条目，可使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmtpMaxMessagesPerConnection

SmtpMaxMessagesPerConnection 参数指定服务器可通过每个连接发送的最大邮件数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SourceIPAddress

SourceIPAddress 参数指定用作指向远程消息服务器的 SMTP 连接终结点的本地 IP 地址。默认 IP 地址是 0.0.0.0。此值表示服务器可以使用任何可用的本地 IP 地址。此参数仅对在边缘服务器上配置的发送连接器有效。

类型:	IPAddress
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SourceTransportServers

SourceTransportServers 参数指定可以使用此发送连接器的邮箱服务器的名称。此参数对在边缘服务器上配置的发送连接器无效。

要添加或移除一个或多个值而不影响任何现有条目，可使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TlsAuthLevel

TlsAuthLevel 参数指定用于此发送连接器建立的出站 TLS 连接的 TLS 身份验证级别。有效值包含:

EncryptionOnly：TLS 仅用于加密通信通道。不执行任何证书身份验证。
CertificateValidation：TLS 用于加密通道，并执行证书链验证和吊销列表检查。
DomainValidation：除通道加密和证书验证之外，发送连接器还将验证目标证书的 FQDN 是否与 TlsDomain 参数中指定的域匹配。如果 TlsDomain 参数中没有指定任何域，则将证书中的 FQDN 与收件人的域进行比较。

如果将 IgnoreSTARTTLS 参数设置为 $true，或将 RequireTLS 参数设置为 $false，则无法指定此参数的值。

类型:	TlsAuthLevel
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TlsCertificateName

TlsCertificateName 参数指定 TLS 加密要使用的 X.509 证书。此参数 "<I>X.500Issuer<S>X.500Subject"的有效值为。在证书的 Issuer 字段中为 X.500Issuer 值，在证书的 Subject 字段中为 X.500Subject 值。可以通过运行 Get-ExchangeCertificate cmdlet 查找这些值。或者，在运行 Get-ExchangeCertificate 查找证书的指纹值后，请运行命令 $TLSCert = Get-ExchangeCertificate -Thumbprint <Thumbprint>、运行命令 $TLSCertName = "<I>$($TLSCert.Issuer)<S>$($TLSCert.Subject)"，然后使用值$TLSCertName此参数。

类型:	SmtpX509Identifier
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TlsDomain

TlsDomain 参数指定发送连接器在建立 TLS 安全连接时用于验证目标证书的 FQDN 的域名。

只有 TlsAuthLevel 参数设置为 DomainValidation 时，才能使用此参数。

如果出现以下情况，此参数的值是必需的：

TLSAuthLevel 参数设置为 DomainValidation。
DNSRoutingEnabled 参数设置为 $false（智能主机发送连接器）。

类型:	SmtpDomainWithSubdomains
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseExternalDNSServersEnabled

UseExternalDNSServersEnabled 参数指定此发送连接器是否使用通过 Set-TransportService cmdlet 的 ExternalDNSServers 参数指定外部 DNS 列表。默认值为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。