通过

Set-ComplianceSecurityFilter

模块:
Exchange PowerShell

此 cmdlet 仅在安全性 & 合规性 PowerShell 中有效。 有关更多信息，请参见 安全与合规中心 PowerShell。

使用 Set-ComplianceSecurityFilter cmdlet 修改Microsoft Purview 合规门户中的符合性安全筛选器。

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

语法

Default （默认值） 

Set-ComplianceSecurityFilter
    -FilterName <String>
    [-Action <ComplianceSecurityFilterActionType>]
    [-Confirm]
    [-Description <String>]
    [-Filters <MultiValuedProperty>]
    [-Region <String>]
    [-Users <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

说明

要在安全与合规中心 PowerShell 中使用此 cmdlet，必须分配权限。 有关详细信息，请参阅 Microsoft Purview 合规门户中的权限。

示例

示例 1

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.add("pilarp@contoso.com")

Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users

本示例将用户 pilarp@contoso.com 添加到名为“渥太华用户筛选器”的符合性安全筛选器，而不影响分配到筛选器的其他用户。

示例 2

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.remove("annb@contoso.com")

Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users

本示例将用户 annb@contoso.com 删除到名为“渥太华用户筛选器”的符合性安全筛选器，而不影响分配到筛选器的其他用户。

参数

-Action

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

Action 参数指定筛选器应用于的搜索作类型。 此参数的有效值为 All，这意味着筛选器将应用于所有搜索作。

  • 导出：导出搜索结果或准备在电子数据展示高级版中进行分析时应用筛选器。
  • 预览：预览搜索结果时应用筛选器。
  • 清除：清除搜索结果时应用筛选器。 删除项的方式由 New-ComplianceSearchAction cmdlet 上的 PurgeType 参数值控制。 默认值为 SoftDelete，这意味着用户可恢复清除的项目，直到已删除邮件的保留期到期。
  • 搜索：运行搜索时应用筛选器。
  • Search：运行搜索时应用筛选器。

参数属性

类型:ComplianceSecurityFilterActionType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Description

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

Description 参数指定合规性安全筛选器的说明。 长度不得超过 256 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FilterName

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

FilterName 参数指定要修改的合规性安全筛选器的名称。 如果值中有空格，请使用双引号 (") 将此值括起来。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Filters

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

Filters 参数指定合规性安全筛选器的搜索条件。 您可以创建三种不同类型的筛选器：

  • 邮箱筛选器：指定可由分配的用户搜索的邮箱。 有效语法为 Mailbox_<MailboxPropertyName>，其中 <MailboxPropertyName> 是邮箱属性值。 例如，"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" 允许用户仅搜索 CustomAttribute10 属性中值为 OttawaUsers 的邮箱。 有关支持的邮箱属性的列表，请参阅 RecipientFilter 参数的可筛选属性。
  • 邮箱内容筛选器：指定分配的用户可以搜索的邮箱内容。 有效语法为 MailboxContent_<SearchablePropertyName>，其中 <SearchablePropertyName> 指定可在合规性搜索中指定的关键字查询语言 (KQL) 属性。 例如， "MailboxContent_Recipients -like 'contoso.com'" 允许用户仅搜索发送到 contoso.com 域中收件人的邮件。 有关可搜索电子邮件属性的列表，请参阅 电子数据展示的关键字查询。
  • 网站和网站内容筛选器：可以创建两个与 SharePoint 和 OneDrive 网站相关的筛选器： Site_<SearchableSiteProperty> (指定与网站相关的属性。例如，"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'" 允许用户仅搜索网站集中的内容 https://contoso.sharepoint.com/sites/doctors) ， (SiteContent_<SearchableSiteProperty> 指定与内容相关的属性。例如， "SiteContent_FileExtension -eq 'docx'" 允许用户仅搜索Word文档) 。 有关可搜索网站属性的列表，请参阅 SharePoint Server 中已爬网属性和托管属性概述。 “可查询”列中标记为“是”的属性可用于创建网站或网站内容筛选器。

您可以指定同一类型的多个筛选器。 例如，"Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'"。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Region

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

Region 参数指定多地理位置租户在中执行电子数据展示搜索的附属位置。 有效值包含:

  • APC：Asia-Pacific
  • 澳大利亚：澳大利亚
  • CAN：加拿大
  • EUR：欧洲、中东、非洲
  • FRA：法国
  • GBR：英国
  • IND：印度
  • JPN：日本
  • LAM：拉丁美洲
  • NAM：北美

如果不在多地理位置租户中使用此参数，则会在中心位置执行电子数据展示搜索。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Users

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

Users 参数指定可将此筛选器应用到搜索的用户。 有效值包含:

  • 一个或多个用户：按其别名或电子邮件地址标识用户。 可以指定用逗号分隔的多个值。
  • 值 All： 将筛选器分配给所有用户。 您只能自行使用此值。
  • 一个或多个角色组：按其名称标识角色组。 可以指定用逗号分隔的多个值。

不能使用此参数指定通讯组。

指定的值将覆盖任何现有条目。 请参阅“示例”部分，在不影响其他现有条目的情况下添加或删除用户。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：Exchange Server 2016、Exchange Server 2019、安全 & 符合性

WhatIf 开关在安全与合规 PowerShell 中不起作用。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。