Get-ComplianceSearchAction

参考

模块:: ExchangePowerShell

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

此 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