Set-HostedConnectionFilterPolicy
此 cmdlet 仅在基于云的服务中可用。
使用 Set-HostedConnectionFilterPolicy cmdlet 修改基于云的组织中的连接筛选器策略设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-HostedConnectionFilterPolicy
[-Identity] <HostedConnectionFilterPolicyIdParameter>
[-AdminDisplayName <String>]
[-ConfigurationXmlRaw <String>]
[-Confirm]
[-EnableSafeList <Boolean>]
[-IPAllowList <MultiValuedProperty>]
[-IPBlockList <MultiValuedProperty>]
[-MakeDefault]
[-WhatIf]
[<CommonParameters>] 说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-HostedConnectionFilterPolicy "Default" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24此示例使用以下设置修改名为 Default 的连接筛选器策略：
- 来自 192.168.1.10 和 192.168.1.23 的邮件永远不会被标识为垃圾邮件。
- 来自 10.10.10.0/25 和 172.17.17.0/24 的邮件始终被标识为垃圾邮件。
示例 2
Set-HostedConnectionFilterPolicy "Default" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5"; Remove="192.168.1.10"}此示例使用以下设置修改名为 Default 的连接筛选器策略：
- 以下 IP 地址添加到 IP 允许列表中的现有值：192.168.2.10、192.169.3.0/24 和 192.168.4.1-192.168.4.5。
- IP 地址 192.168.1.10 将从 IP 允许列表中的现有值中删除。
参数
-AdminDisplayName
AdminDisplayName 参数指定策略的说明。 如果值中有空格，请使用双引号 (") 将此值括起来。 最大长度为 255 个字符。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConfigurationXmlRaw
保留此参数以供 Microsoft 内部使用。
| 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 |
-EnableSafeList
EnableSafeList 参数启用或禁用安全列表。 安全列表为 Microsoft 数据中心中的动态允许列表，不要求任何客户配置。 有效值包含:
$true：使用安全列表可跳过来自 Microsoft 订阅的各种第三方源标识的受信任发件人的邮件的垃圾邮件筛选。
$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
通常，只有一个连接筛选器策略：名为 Default 的默认策略。
| Type: | HostedConnectionFilterPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IPAllowList
IPAllowList 参数指定来自其 IP 地址的邮件总是为允许的 IP 地址。 来自您指定的 IP 地址的邮件不会表示为垃圾邮件，即使邮件中有任何其他垃圾邮件特征。 有效值包含:
- 单个 IP 地址：例如 192.168.1.1。
- IP 地址范围：可以使用 IP 地址范围，例如 192.168.0.1-192.168.0.254。 范围中的最大地址数为 256。
- 无类域间路由 (CIDR) IP 地址范围：例如 192.168.0.1/25。 有效的子网掩码值为 /24 到 /32。
可以指定同一类型的多个 IP 地址，用逗号分隔。 例如，SingleIP1, SingleIP2,...SingleIPN 或 CIDRIP1,CIDRIP2,...CIDRIPN。 若要同时指定不同类型的多个 IP 地址，需要使用以下多值属性语法： @{Add="SingleIP1","IPRange1","CIDRIP1",...}。
注意：不支持 IPv6 范围。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IPBlockList
IPBlockList 参数指定来自其 IP 地址的邮件总是为不允许的 IP 地址。 来自您指定的 IP 地址的邮件不需进一步垃圾邮件扫描就被阻止。 有效值包含:
- 单个 IP 地址：例如 192.168.1.1。
- IP 地址范围：可以使用 IP 地址范围，例如 192.168.0.1-192.168.0.254。 范围中的最大地址数为 256。
- 无类域间路由 (CIDR) IP 地址范围：例如 192.168.0.1/25。 有效的子网掩码值为 /24 到 /32。
可以指定同一类型的多个 IP 地址，用逗号分隔。 例如，SingleIP1, SingleIP2,...SingleIPN 或 CIDRIP1,CIDRIP2,...CIDRIPN。 若要同时指定不同类型的多个 IP 地址，需要使用以下多值属性语法： @{Add="SingleIP1","IPRange1","CIDRIP1",...}。
注意：不支持 IPv6 范围。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MakeDefault
保留此参数以供 Microsoft 内部使用。
| Type: | SwitchParameter |
| 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 不返回任何数据。