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
适用：Exchange Online、Exchange Online Protection
AssociatedAcceptedDomains 参数将使用连接器的源域限制为指定的接受域。 有效值是配置为 Microsoft 365 组织中的接受域的 SMTP 域。
可以指定用逗号分隔的多个值。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CloudServicesMailEnabled
适用：Exchange Online、Exchange Online Protection
注意：建议不要使用此参数，除非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
适用：Exchange Online、Exchange Online Protection
Comment 参数指定可选注释。 如果您指定包含空格的值，为该值加上双引号(")，例如："这是管理员备注"。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
适用：Exchange Online、Exchange Online Protection
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ConnectorSource
适用：Exchange Online、Exchange Online Protection
ConnectorSource 参数指定如何创建连接器。 此参数的有效输入包括以下值：
- Default：连接器为手动创建。 此值为默认值。
- HybridWizard：连接器由混合配置向导自动创建。
- Migrated：连接器最初在 Microsoft Forefront Online Protection for Exchange 中创建。
建议不要更改此值。
| 类型: | TenantConnectorSource |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ConnectorType
适用：Exchange Online、Exchange Online Protection
ConnectorType 参数指定连接器服务域的类别。 此参数的有效输入包括以下值：
- Partner：连接器服务组织外部的域。
- OnPremises：连接器服务内部部署组织使用的域。 OnPremises 连接器向符合连接器和其他要求的电子邮件授予特殊权限。 例如：允许通过租户中继到 Internet 目标，将来自本地或其他环境的电子邮件提升为混合配置) 中的内部 (，或者启用其他更复杂的邮件流。
| 类型: | TenantConnectorType |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EFSkipIPs
适用：Exchange Online、Exchange Online Protection
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。
可以指定用逗号分隔的多个值。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EFSkipLastIP
适用：Exchange Online、Exchange Online Protection
EFSkipIPs 参数指定连接器增强筛选的行为。 有效值包含:
- $true：仅跳过最后一个消息源。
- $false：跳过 EFSkipIPs 参数指定的源 IP 地址。 如果未指定 IP 地址，则会在连接器上禁用连接器的增强筛选。 此值为默认值。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EFSkipMailGateway
适用：Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EFTestMode
适用：Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EFUsers
适用：Exchange Online、Exchange Online Protection
EFUsers 参数指定连接器增强筛选应用于的收件人。 默认值为空白 ($null) ，这意味着连接器的增强筛选将应用于所有收件人。
可以指定多个收件人电子邮件地址，中间用逗号分隔。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Enabled
适用：Exchange Online、Exchange Online Protection
Enabled 参数启用或禁用连接器。 有效值包含:
- $true：连接器已启用。 此值为默认值。
- $false：连接器已禁用。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Identity
适用：Exchange Online、Exchange Online Protection
Identity 参数指定要更改的入站连接器。
| 类型: | InboundConnectorIdParameter |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
适用：Exchange Online、Exchange Online Protection
Name 参数指定连接器的描述性名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RequireTls
适用：Exchange Online、Exchange Online Protection
RequireTLS 参数指定是否要求对合作伙伴类型连接器接收的所有消息进行 TLS 传输。 有效值包含:
- $true：如果邮件不是通过 TLS 发送的，则拒绝这些消息。 此为默认值
- $false：如果消息不是通过 TLS 发送的，则允许它们。
注意：此参数仅适用于合作伙伴类型连接器。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RestrictDomainsToCertificate
适用：Exchange Online、Exchange Online Protection
RestrictDomainsToCertificate 参数指定在邮件可以使用合作伙伴类型连接器之前是否检查 TLS 证书的 Subject 值。 有效值包含:
- $true：仅当源电子邮件服务器用于进行身份验证的 TLS 证书的 Subject 值与 TlsSenderCertificateName 参数值匹配时，才允许邮件使用连接器。
- $false：源电子邮件服务器用于进行身份验证的 TLS 证书的 Subject 值无法控制来自该源的邮件是否使用连接器。 此值为默认值。
注意：此参数仅适用于合作伙伴类型连接器。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RestrictDomainsToIPAddresses
适用：Exchange Online、Exchange Online Protection
RestrictDomainsToIPAddresses 参数指定是否拒绝来自合作伙伴类型连接器的未知源 IP 地址的邮件。 有效值包含:
- $true：如果源 IP 地址未同时由 SenderIPAddress 参数指定，则自动拒绝来自 SenderDomains 参数指定的域的邮件。
- $false：不要根据源 IP 地址自动拒绝发件人域参数指定的域的邮件。 此值为默认值。
注意：此参数仅适用于合作伙伴类型连接器。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ScanAndDropRecipients
适用：Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SenderDomains
适用：Exchange Online、Exchange Online Protection
SenderDomains 参数指定合作伙伴类型连接器接受消息的源域， (限制合作伙伴类型连接器) 的范围。 有效值为 SMTP 域。 支持通配符来指示域和所有子域 (， *.contoso.com 例如，) 。 但是，不能嵌入通配符 (例如， domain.*.contoso.com) 无效。
可以指定多个域，中间用逗号隔开。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SenderIPAddresses
适用：Exchange Online、Exchange Online Protection
当 RestrictDomainsToIPAddresses 参数的值$true时，SenderIPAddresses 参数指定合作伙伴类型连接器接受消息的源 IPV4 IP 地址。 有效值包含:
- 单个 IP 地址：例如 192.168.1.1。
- 无类别域际路由选择 (CIDR) IP 地址范围：例如 192.168.0.1/25。 有效的子网掩码值为 /24 到 /32。 @@ -435,6 +441,8 @@ 可以指定用逗号分隔的多个 IP 地址。
不支持 IPv6 地址。
注意：仅当 RestrictDomainsToIPAddresses 参数的值$true时，此参数才应用于合作伙伴类型连接器。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TlsSenderCertificateName
适用：Exchange Online、Exchange Online Protection
TlsSenderCertificateName 参数指定在 RequireTls 参数的值$true时使用的 TLS 证书。 有效值为 SMTP 域。 支持通配符来指示域和所有子域 (例如 *.contoso.com) ，但不能嵌入通配符 (例如 domain.*.contoso.com) 无效。
| 类型: | TlsCertificate |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TreatMessagesAsInternal
适用：Exchange Online、Exchange Online Protection
TreatMessagesAsInternal 参数指定一种替代方法，用于将从本地组织发送的消息标识为内部消息。 仅当本地组织不使用 Exchange 时，才应考虑使用此参数。 有效值包含:
- $true：如果发件人的域与在 Microsoft 365 中配置的域匹配，则邮件被视为内部消息。 此设置允许Microsoft 365 与未安装 Exchange Server 2010 或更高版本的本地组织之间的内部邮件流。 但是，此设置具有潜在的安全风险， (例如，内部消息绕过反垃圾邮件筛选) ，因此在配置此设置时要小心。
- $false：消息不被视为内部消息。 此值为默认值。
在混合环境中，无需使用此参数，因为混合配置向导会自动在 Microsoft 365 中的入站连接器和本地 Exchange 组织中的发送连接器上配置所需设置， (CloudServicesMailEnabled 参数) 。
注意：如果满足以下任一条件，则不能将此参数设置为值$true：
- CloudServicesMailEnabled 参数设置为$true值。
- ConnectorType 参数值不是 OnPremises。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TrustedOrganizations
适用：Exchange Online、Exchange Online Protection
TrustedOrganizations 参数指定其他Microsoft 365 个组织，这些组织是受信任的邮件源 (，例如，在收购和合并) 之后。 此参数仅适用于两个Microsoft 365 个组织之间的邮件流，因此不使用其他参数。
若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
要添加或移除一个或多个值而不影响任何现有条目，可使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
适用：Exchange Online、Exchange Online Protection
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。