Get-ComplianceSearch

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。

使用 Get-ComplianceSearch cmdlet 查看Exchange Server 2016 或更高版本以及Microsoft Purview 合规门户中的估计符合性搜索。 在使用 New-ComplianceSearchAction cmdlet 定义合规性搜索预览操作后,可以使用 Get-ComplianceSearchAction cmdlet 查看合规性搜索的结果。

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

语法

Default (默认值)

Get-ComplianceSearch
    [[-Identity] <ComplianceSearchIdParameter>]
    [-Case <String>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

在本地 Exchange 中,此 cmdlet 在邮箱搜索角色中可用。 默认情况下,此角色仅分配给发现管理角色组。

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

示例

示例 1

Get-ComplianceSearch

本示例显示所有合规性搜索的摘要列表。

示例 2

Get-ComplianceSearch -Identity "Case 1234" | Format-List

本示例显示名为“案例 1234”的合规性搜索的详细信息。

参数

-Case

适用:安全 & 合规性

此参数仅在基于云的服务中可用。

Case 参数按与符合性搜索关联的电子数据展示Standard事例的名称筛选结果。 如果值包含空格,则使用引号括住该值。

不能使用此参数来查看与电子数据展示高级版案例关联的合规性搜索。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性

Identity 参数指定要查看的合规性搜索。

使用此参数时,必须使用 Identity 参数,但可忽略值。 例如,对 Identity 参数使用值 000。

  • 名称
  • JobRunId (GUID)

JobRunId (GUID)

为了提高此 cmdlet 的性能,如果未指定合规性搜索的标识,则不会返回某些符合性搜索属性。 这些属性包括:

  • 项目
  • Size
  • SuccessResults
  • NumBindings
  • ExchangeLocation
  • SharePointLocation
  • OneDriveLocation

若要查看这些属性,需要在 命令中使用 Identity 参数。

注意:NumBindings 属性包括主邮箱、主存档以及搜索中包含的用户的任何其他存档。 NumBindings 不是搜索中包含的用户数,因为每个包含的用户可能具有或没有主邮箱、主存档和其他存档的组合。

参数属性

类型:ComplianceSearchIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResultSize

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、安全 & 符合性

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。

参数属性

类型:Unlimited
默认值: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