Get-ComplianceSecurityFilter
此 cmdlet 仅在安全性 & 合规性 PowerShell 中有效。 有关更多信息，请参见 安全与合规中心 PowerShell。
使用 Get-ComplianceSecurityFilter cmdlet 查看Microsoft Purview 合规门户中的符合性安全筛选器。 这些筛选器允许指定用户仅搜索Microsoft 365 组织中的一部分邮箱和 SharePoint 或 OneDrive 网站。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
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
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性
Action 参数按应用筛选器的搜索作类型筛选结果。 有效值包含:
- 导出：导出搜索结果或准备在电子数据展示高级版中进行分析时应用筛选器。
- 预览：预览搜索结果时应用筛选器。
- 清除：清除搜索结果时应用筛选器。 删除项的方式由 New-ComplianceSearchAction cmdlet 上的 PurgeType 参数值控制。 默认值为 SoftDelete，这意味着用户可恢复清除的项目，直到已删除邮件的保留期到期。
- 搜索：运行搜索时应用筛选器。
- Search：运行搜索时应用筛选器。
参数属性
| 类型: | ComplianceSecurityFilterActionType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性
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 |
-FilterName
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性
FilterName 参数指定要查看的合规性安全筛选器的名称。 如果值中有空格，请使用双引号 (") 将此值括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-User
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性
User 参数按获取应用于其搜索的筛选器的用户筛选结果。 有效值包含:
- 用户的别名或电子邮件地址。
- 值 All。
- 角色组的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性
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。