Get-ComplianceSecurityFilter

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

使用 Get-ComplianceSecurityFilter cmdlet 查看Microsoft Purview 合规门户中的符合性安全筛选器。 这些筛选器允许指定用户仅搜索一部分邮箱和 SharePoint Online 或 Microsoft 365 组织中的OneDrive for Business网站。

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

语法

Get-ComplianceSecurityFilter
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-FilterName <String>]
   [-User <String>]
   [-WhatIf]
   [<CommonParameters>]

说明

合规性安全筛选器适用于 Microsoft Purview 合规门户 (*-ComplianceSearch cmdlet) 中的合规性搜索,而不是In-Place Exchange Online (*-MailboxSearch cmdlet) 中的电子数据展示搜索。

若要在安全性 & 合规性 PowerShell 中使用此 cmdlet,需要分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限

示例

示例 1

Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action

本示例返回所有合规性安全筛选器的摘要列表。

示例 2

Get-ComplianceSecurityFilter -FilterName "HR Filter"

本示例返回有关名为“HR Filter”的合规性安全筛选器的详细信息。

参数

-Action

Action 参数按应用筛选器的搜索操作类型筛选结果。 有效值包含:

  • 导出:导出搜索结果或准备在电子数据展示高级版中进行分析时应用筛选器。
  • 预览:预览搜索结果时应用筛选器。
  • 清除:清除搜索结果时应用筛选器。 删除项的方式由 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

-FilterName

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

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

-User

User 参数按获取应用于其搜索的筛选器的用户筛选结果。 有效值为:

  • 用户的别名或电子邮件地址。
  • 值 All。
  • 角色组的名称。
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

-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