Set-ComplianceSecurityFilter

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2016, Exchange Server 2019, Security & Compliance

此 cmdlet 仅在安全性 & 合规性 PowerShell 中有效。有关详细信息，请参阅安全性 & 合规性 PowerShell。

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

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

语法

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 OttawaUsersFilter -Users $filterusers.users

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

示例 2

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

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

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

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

参数

-Action

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

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

Type:	ComplianceSecurityFilterActionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-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 Server 2016, Exchange Server 2019, Security & Compliance

-Description

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-FilterName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Filters

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

邮箱筛选器：指定可由分配的用户搜索的邮箱。有效语法为 Mailbox_<MailboxPropertyName>，其中 <MailboxPropertyName> 是邮箱属性值。例如，"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" 允许用户仅搜索 CustomAttribute10 属性中值为 OttawaUsers 的邮箱。有关支持的邮箱属性列表，请参阅 RecipientFilter 参数的可筛选属性。
邮箱内容筛选器：指定分配的用户可以搜索的邮箱内容。有效语法为 MailboxContent_<SearchablePropertyName>，其中 <SearchablePropertyName> 指定可在合规性搜索中指定的关键字查询语言 (KQL) 属性。例如， "MailboxContent_Recipients -like 'contoso.com'" 允许用户仅搜索发送到 contoso.com 域中收件人的邮件。有关可搜索电子邮件属性的列表，请参阅电子数据展示的关键字查询。
网站和网站内容筛选器：可以创建两个 SharePoint Online 和OneDrive for Business网站相关筛选器： 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)'"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Region

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Users

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

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

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

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

通过