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