Set-OutboundConnector

模块:

ExchangePowerShell

适用于:

Exchange Online, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 Set-OutboundConnector cmdlet 修改基于云的组织中的现有出站连接器。

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

语法

Set-OutboundConnector
   [-Identity] <OutboundConnectorIdParameter>
   [-AllAcceptedDomains <Boolean>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-Enabled <Boolean>]
   [-IsTransportRuleScoped <Boolean>]
   [-IsValidated <Boolean>]
   [-LastValidationTimestamp <DateTime>]
   [-Name <String>]
   [-RecipientDomains <MultiValuedProperty>]
   [-RouteAllMessagesViaOnPremises <Boolean>]
   [-SenderRewritingEnabled <Boolean>]
   [-SmartHosts <MultiValuedProperty>]
   [-TestMode <Boolean>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-TlsSettings <TlsAuthLevel>]
   [-UseMXRecord <Boolean>]
   [-ValidationRecipients <String[]>]
   [-WhatIf]
   [<CommonParameters>]

说明

出站连接器将电子邮件发送至要求特定配置选项的远程域。

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

示例

示例 1

Set-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1

该示例更改现有名为 Contoso Outbound Connector 的出站连接器的设置，以路由至在 IP 地址 192.168.0.1 的智能主机。

参数

-AllAcceptedDomains

AllAcceptedDomains 参数指定是否在邮件收件人位于基于云的组织的接受域中的混合组织中使用出站连接器。 有效值包含:

• $true：当邮件收件人位于基于云的组织的接受域中时，出站连接器在混合组织中使用。 此设置需要对 ConnectorType 值使用 OnPremises。
• $false：混合组织中不使用出站连接器。 此值为默认值。

此参数仅对 OnPremises 连接器有效。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-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：连接器不用于混合组织中的邮件流，因此将从流经连接器的邮件中删除任何跨界标头。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Comment

Comment 参数指定可选注释。 如果您指定包含空格的值，为该值加上双引号(")，例如："这是管理员备注"。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ConnectorSource

ConnectorSource 参数指定如何创建连接器。 有效值包含:

• Default：连接器为手动创建。 这是手动创建的连接器的默认值，建议不要更改此值。
• HybridWizard：连接器由混合配置向导自动创建。
• Migrated：连接器最初在 Microsoft Forefront Online Protection for Exchange 中创建。

Type:	TenantConnectorSource
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ConnectorType

ConnectorType 参数指定连接器服务域的类别。 有效值包含:

• Partner：连接器服务组织外部的域。
• OnPremises：连接器服务内部部署组织使用的域。

Type:	TenantConnectorType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Enabled

Enabled 参数指定是启用或禁用出站连接器。 有效值包含:

• $true：连接器已启用。 此值为默认值。
• $false：连接器已禁用。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Identity 参数指定要修改的连接器。 您可以使用唯一标识连接器的任何值。 例如：

• 名称
• 可分辨名称 (DN)
• GUID

Type:	OutboundConnectorIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsTransportRuleScoped

IsTransportRuleScoped 参数指定出站连接器是否与传输规则 (也称为邮件流规则) 相关联。 有效值包含:

• $true：连接器与传输规则相关联。
• $false：连接器不与传输规则关联。 此值为默认值。

可以使用 New-TransportRule 或 Set-TransportRule cmdlet 上的 RouteMessageOutboundConnector 参数将传输规则限定为出站连接器。 使用指定的出站连接器将符合传输规则条件的邮件路由到其目标。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsValidated

IsValidated 参数指定是否已验证出站连接器。 有效值包含:

• $true：连接器已经过验证，
• $false：连接器尚未验证。 此值为默认值。

使用 Validate-OutboundConnector cmdlet 验证连接器。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-LastValidationTimestamp

LastValidationTimestamp 参数指定验证出站连接器的日期/时间。

若要指定此参数的日期/时间值，请使用下列方法之一：

• 指定 UTC 中的日期/时间值：例如，“2021-05-06 14：30：00z”。
• 将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如 (Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 有关详细信息，请参阅 Get-Date。

使用 Validate-OutboundConnector cmdlet 验证连接器。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Name

Name 参数指定连接器的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientDomains

RecipientDomains 参数指定出站连接器将邮件路由到的域。 可以指定多个域，中间用逗号隔开。

可以使用通配符来指定某个指定域的所有子域，如下例所示：*.contoso.com。 但是，不能嵌入通配符，如以下示例所示：domain.*.contoso.com。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RouteAllMessagesViaOnPremises

RouteAllMessagesViaOnPremises 参数指定首先通过本地电子邮件系统路由此连接器服务的所有邮件。 有效值包含:

• $true：邮件通过本地电子邮件系统路由。 此设置需要对 ConnectorType 值使用 OnPremises。
• $false：邮件不会通过本地电子邮件系统路由。 此值为默认值。

此参数仅对 OnPremises 连接器有效。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderRewritingEnabled

SenderRewritingEnabled 参数指定通常符合 SRS 重写条件的所有邮件将重写为通过本地电子邮件系统进行路由。 有效值包含:

• $true：在通过本地电子邮件系统路由之前，SRS 会根据需要重写邮件。 此设置需要对 ConnectorType 值使用 OnPremises。
• $false：在通过本地电子邮件系统路由之前，SRS 不会重写邮件。 此值为默认值。

此参数仅对 OnPremises 连接器有效。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SmartHosts

SmartHosts 参数指定出站连接器用于路由邮件的智能主机。 有效值包含:

• 智能主机服务器的 FQDN、邮件交换 (MX) 记录或地址 () 记录：例如，mail.contoso.com。
• 单个 IP 地址：例如 10.10.1.1。
• 无类域间路由 (CIDR) IP 地址范围：例如 192.168.0.1/25。

可以指定用逗号分隔的多个值： "Value1","Value2",..."ValueN"。

如果使用 UseMxRecord 参数的值$false，则此参数是必需的。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TestMode

TestMode 参数指定是要为出站连接器启用或禁用测试模式。 有效值包含:

• $true：已启用测试模式。
• $false：禁用测试模式。 此值为默认值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TlsDomain

TlsDomain 参数指定出站连接器在建立 TLS 安全连接时用于验证目标证书的 FQDN 的域名。 此参数的有效值为 SMTP 域。

支持通配符指定域 (的所有子域，例如 *.contoso.com) ，但不能将通配符嵌入域 (例如 domain.*.contoso.com) 。

仅当 TlsSettings 值为 DomainValidation 时，此参数才有意义。

Type:	SmtpDomainWithSubdomains
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TlsSettings

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

• EncryptionOnly：TLS 仅用于加密通信通道。 不执行任何证书身份验证。
• CertificateValidation：TLS 用于加密通道，并执行证书链验证和吊销列表检查。
• DomainValidation：除了通道加密和证书验证外，出站连接器还验证目标证书的 FQDN 是否与 TlsDomain 参数中指定的域匹配。
• $null (空白) ：这是默认值。

Type:	TlsAuthLevel
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-UseMXRecord

UseMXRecord 参数启用或禁用连接器的 DNS 路由。 有效值包含:

• $true：连接器使用 DNS) 中的 DNS 路由 (MX 记录来传递电子邮件。 此值为默认值。
• $false：连接器将电子邮件传递到一个或多个智能主机。 此设置需要一个或多个智能主机作为 SmartHosts 值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ValidationRecipients

ValidationRecipients 参数指定出站连接器的验证收件人的电子邮件地址。 可以指定多个电子邮件地址，中间用逗号分隔。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

输入

Input types

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

输出

Output types

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