Set-InboundConnector

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

使用 Set-InboundConnector cmdlet 更改基于云的组织中已有的入站连接器。

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

语法

Set-InboundConnector
   [-Identity] <InboundConnectorIdParameter>
   [-AssociatedAcceptedDomains <MultiValuedProperty>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-EFSkipIPs <MultiValuedProperty>]
   [-EFSkipLastIP <Boolean>]
   [-EFSkipMailGateway <MultiValuedProperty>]
   [-EFTestMode <Boolean>]
   [-EFUsers <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-Name <String>]
   [-RequireTls <Boolean>]
   [-RestrictDomainsToCertificate <Boolean>]
   [-RestrictDomainsToIPAddresses <Boolean>]
   [-ScanAndDropRecipients <MultiValuedProperty>]
   [-SenderDomains <MultiValuedProperty>]
   [-SenderIPAddresses <MultiValuedProperty>]
   [-TlsSenderCertificateName <TlsCertificate>]
   [-TreatMessagesAsInternal <Boolean>]
   [-TrustedOrganizations <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

说明

入站连接器接受来自要求特定配置选项的远程域的电子邮件。

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

示例

示例 1

Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

该示例将以下配置更改用于现有的名为 Contoso.com 入站连接器的入站连接器。

在连接器上的所有传入邮件都要求 TLS 传输。

要求用于加密通信的 TLS 证书包含域名 contoso.com

参数

-AssociatedAcceptedDomains

AssociatedAcceptedDomains 参数将使用连接器的源域限制为指定的接受域。 有效值是配置为 Microsoft 365 组织中接受域的 SMTP 域。

可以指定用逗号分隔的多个值。

Type:MultiValuedProperty
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:连接器服务内部部署组织使用的域。 将此值用于基于云的组织中接受的域,这些域也由 SenderDomains 参数指定。
Type:TenantConnectorType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipIPs

EFSkipIPs 参数指定要在 EFSkipLastIP 参数值$false时在连接器增强筛选中跳过的源 IP 地址。 有效值包含:

  • 单个 IP 地址:例如 192.168.1.1。
  • IP 地址范围:例如 192.168.0.1-192.168.0.254。
  • 无类域间路由 (CIDR) IP 地址范围:例如 192.168.3.1/24。

可以指定用逗号分隔的多个值。

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

-EFSkipLastIP

EFSkipIPs 参数指定连接器增强筛选的行为。 有效值包含:

  • $true:仅跳过最后一个消息源。
  • $false:跳过 EFSkipIPs 参数指定的源 IP 地址。 如果未指定 IP 地址,则会在连接器上禁用连接器的增强筛选。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipMailGateway

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

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

-EFTestMode

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

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

-EFUsers

EFUsers 参数指定连接器增强筛选应用于的收件人。 默认值为空白 ($null) ,这意味着连接器的增强筛选将应用于所有收件人。

可以指定多个收件人电子邮件地址,中间用逗号分隔。

Type:MultiValuedProperty
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 参数指定要更改的入站连接器。

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

-Name

Name 参数指定连接器的描述性名称。

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

-RequireTls

RequireTLS 参数指定是否要求对连接器接收的所有消息进行 TLS 传输。 有效值包含:

  • $true:如果邮件不是通过 TLS 发送的,则拒绝这些消息。 此为默认值
  • $false:如果消息不是通过 TLS 发送的,则允许它们。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToCertificate

RestrictDomainsToCertificate 参数指定在消息可以使用连接器之前是否检查 TLS 证书的 Subject 值。 有效值包含:

  • $true:仅当源电子邮件服务器用于进行身份验证的 TLS 证书的 Subject 值与 TlsSenderCertificateName 参数值匹配时,才允许邮件使用连接器。
  • $false:源电子邮件服务器用于进行身份验证的 TLS 证书的 Subject 值无法控制来自该源的邮件是否使用连接器。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToIPAddresses

RestrictDomainsToIPAddresses 参数指定是否拒绝来自未知源 IP 地址的邮件。 有效值包含:

  • $true:如果源 IP 地址未同时由 SenderIPAddress 参数指定,则自动拒绝来自 SenderDomains 参数指定的域的邮件。
  • $false:不要根据源 IP 地址自动拒绝发件人域参数指定的域的邮件。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ScanAndDropRecipients

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

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

-SenderDomains

SenderDomains 参数指定连接器接受其消息的源域。 有效值为 SMTP 域。 支持通配符指示域和所有子域 (例如 *.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

-SenderIPAddresses

SenderIPAddresses 参数指定此连接器接受消息的远程 IPV4 IP 地址。 不支持 IPv6 地址。 有效值包含:

  • 单个 IP 地址:例如 192.168.1.1。
  • 无类域间路由 (CIDR) IP 地址范围:例如 192.168.0.1/25。 有效的子网掩码值为 /24 到 /32。

可以指定用逗号分隔的多个值。

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

-TlsSenderCertificateName

TlsSenderCertificateName 参数指定在 RequireTls 参数的值$true时使用的 TLS 证书。 有效值为 SMTP 域。 支持通配符指示域和所有子域 (例如 *.contoso.com) ,但不能嵌入通配符 (例如 domain.*.contoso.com) 无效。

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

-TreatMessagesAsInternal

TreatMessagesAsInternal 参数指定一种替代方法,用于将从本地组织发送的消息标识为内部消息。 仅当本地组织不使用 Exchange 时,才应考虑使用此参数。 有效值包含:

  • $true:如果发件人的域与 Microsoft 365 中配置的域匹配,则邮件被视为内部邮件。 此设置允许 Microsoft 365 与未安装 Exchange Server 2010 或更高版本的本地组织之间的内部邮件流。 但是,此设置具有潜在的安全风险, (例如,内部消息绕过反垃圾邮件筛选) ,因此在配置此设置时要小心。
  • $false:消息不被视为内部消息。 此值为默认值。

在混合环境中,无需使用此参数,因为混合配置向导会自动在 Microsoft 365 中的入站连接器和本地 Exchange 组织中的发送连接器上配置所需的设置, (CloudServicesMailEnabled 参数) 。

注意:如果满足以下任一条件,则不能将此参数设置为值$true:

  • CloudServicesMailEnabled 参数设置为$true值。
  • ConnectorType 参数值不是 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

-TrustedOrganizations

TrustedOrganizations 参数指定其他 Microsoft 365 组织,这些组织是受信任的邮件源 (,例如,在收购和合并) 之后。 此参数仅适用于两个 Microsoft 365 组织之间的邮件流,因此不使用其他参数。

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

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

Type:MultiValuedProperty
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 不返回任何数据。