Get-ComplianceSearchAction
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-ComplianceSearchAction cmdlet 查看有关合规性搜索操作的信息。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>]
说明
在使用 New-ComplianceSearch cmdlet 创建并运行合规性搜索,并使用 Start-ComplianceSearch cmdlet 开始搜索后,您可以使用 New-ComplianceSearchAction cmdlet 分配一个搜索操作。 使用 Get-ComplianceSearchAction cmdlet 可以跟踪合规性搜索操作的进度。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
在本地 Exchange 中,此 cmdlet 在邮箱搜索角色中可用。 默认情况下,此角色仅分配给发现管理角色组。
若要在安全性 & 合规性 PowerShell 中使用此 cmdlet,需要分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限。
示例
示例 1
Get-ComplianceSearchAction
本示例显示所有合规性搜索操作的摘要列表。
示例 2
Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List
本示例显示有关名为“案例 1234_Preview”的合规性搜索操作的详细信息
参数
-Case
此参数仅在基于云的服务中可用。
Case 参数按指定事例的名称筛选结果。 如果值包含空格,则使用引号括住该值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Details
Details 开关指定是否在结果中包括详细信息。 不必为此开关指定值。
Type: | SwitchParameter |
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 |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Export
Export 开关按 Export 合规性搜索操作筛选结果。 不必为此开关指定值。
不能将此开关与“标识”、“预览”或“清除”参数一起使用。
Type: | SwitchParameter |
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 |
-Identity
Identity 参数指定要查看的合规性搜索操作。 可以使用唯一标识合规性搜索操作的任何值。 例如:
- 名称:符合性搜索操作名称使用语法
"Compliance Search Name_Action"
。 例如,"Case 1234_Preview"
。 - JobRunId (GUID)
不能将此参数与导出、预览或清除参数一起使用。
使用 Identity 参数时,将在结果中返回更多详细信息。 例如:
- 在“结果”行中,将填充“项计数”、“总大小”和“详细信息”属性的值。
- 位置线将添加到结果中。
- 将填充 NumBinding 属性值。
- 受影响的位置属性 (例如,将填充 ExchangeLocation) 。
- 将填充 CaseName 属性值。
Type: | ComplianceSearchActionIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-IncludeCredential
IncludeCredential 开关指定是否在结果中包含凭据。 不必为此开关指定值。
Type: | SwitchParameter |
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 |
-Preview
Preview 开关按 Preview 合规性搜索操作筛选结果。 不必为此开关指定值。
不能将此开关与“导出”、“标识”或“清除”参数一起使用。
Type: | SwitchParameter |
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 |
-Purge
注意:在安全性 & 合规性 PowerShell 中,此参数仅在“搜索和清除”角色中可用。 默认情况下,此角色仅分配给组织管理和数据调查员角色组。
Purge 开关按 Purge 合规性搜索操作筛选结果。 不必为此开关指定值。
不能将此开关与导出、标识或预览参数一起使用。
Type: | SwitchParameter |
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 |
-ResultSize
ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。
Type: | Unlimited |
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 |