Set-ComplianceSearch

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

使用 Set-ComplianceSearch cmdlet 修改 Exchange Server 2016 或更高版本以及 Microsoft 365 合规性中心中的未Microsoft 365搜索。

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

语法

Set-ComplianceSearch
   [-Identity] <ComplianceSearchIdParameter>
   [-AddExchangeLocation <String[]>]
   [-AddExchangeLocationExclusion <String[]>]
   [-AddSharePointLocation <String[]>]
   [-AddSharePointLocationExclusion <String[]>]
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-Name <String>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-RemoveExchangeLocation <String[]>]
   [-RemoveExchangeLocationExclusion <String[]>]
   [-RemovePublicFolderLocation <String[]>]
   [-RemoveSharePointLocation <String[]>]
   [-RemoveSharePointLocationExclusion <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-WhatIf]
   [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

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

若要在安全与合规& PowerShell 中使用此 cmdlet,需要分配有权限。 有关详细信息,请参阅安全与合规中心Microsoft 365权限

示例

示例 1

Set-ComplianceSearch -Identity "Project X" -ExchangeLocation All

此示例更改名为 X 的现有合规性Project搜索。该搜索Exchange更改为所有邮箱。

示例 2

Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $null

本示例将更改与网站合规中心中的电子数据展示Microsoft 365搜索。 搜索的范围从搜索所选邮箱和 SharePoint 网站更改为搜索电子数据展示案例中已置于保留状态的所有内容位置。

示例 3

Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CN

本示例将现有合规性搜索的语言设置更改为中文。

如果您在搜索查询查询中使用非英语关键字,则您可能必须更改语言设置 (该查询是在 ContentMatchQuery 参数) 。

参数

-AddExchangeLocation

GUID

  • 常规用户邮箱。 包括其他类型的邮箱 (例如,非活动邮箱或 Microsoft 365 来宾) 由 AllowNotFoundExchangeLocationsEnabled 参数控制。
  • 邮箱

若要指定邮箱或通讯组,请使用电子邮件地址。 可以指定用逗号分隔的多个值。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-AddExchangeLocationExclusion

此参数仅在本地部署中可用或Exchange。

当您对 ExchangeLocation 参数使用值 All 时,此参数指定要添加到已排除邮箱列表中的邮箱。 有效值为:

  • 常规用户邮箱。 包括其他类型的邮箱 (例如,非活动邮箱或 Microsoft 365 来宾) 由 AllowNotFoundExchangeLocationsEnabled 参数控制。
  • 邮箱

若要指定邮箱或通讯组,请使用电子邮件地址。 可以指定用逗号分隔的多个值。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-AddSharePointLocation

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

AddSharePointLocation 参数指定SharePoint SharePointLocation 参数的值 All 时要添加到已包含网站列表中的联机网站。 可以按 URL 值标识网站。

Update 如果值包含空格或需要引号,请使用以下语法 "Value1","Value2",..."ValueN" : 。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-AddSharePointLocationExclusion

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

保留此参数以供 Microsoft 内部使用。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-AllowNotFoundExchangeLocationsEnabled

AllowNotFoundExchangeLocationsEnabled 参数指定是否在合规性搜索中包括常规用户邮箱外的其他邮箱。 有效值为:

  • $true:在继续之前,搜索不会尝试验证邮箱是否存在。 如果要搜索不解析为常规邮箱的邮箱,则此值是必需的。
  • $false:搜索尝试在继续之前验证邮箱是否存在。 如果指定不是常规用户邮箱的邮箱,搜索将失败。 此值为默认值。

受此参数值影响的邮箱类型包括:

  • 非活动邮箱
  • 没有许可证的用户Exchange Online应用程序Office许可证
  • 来宾用户
  • 其标识与组织同步Microsoft 365用户
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如,Remove-* cmdlet)内置有暂停,可强制要求你先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如,New-* and Set-*)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-ContentMatchQuery

ContentMatchQuery 参数指定内容搜索筛选器。

此参数使用通过关键字查询语言 (KQL) 设置格式的文本搜索字符串或查询。 有关 KQL 的详细信息,请参阅关键字查询语言 (KQL) 语法参考

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Description

Description 参数指定合规性搜索说明。如果值包含空格,则使用引号括住该值。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-ExchangeLocation

GUID

  • 常规用户邮箱。 包括其他类型的邮箱 (例如,非活动邮箱或 Microsoft 365 来宾) 由 AllowNotFoundExchangeLocationsEnabled 参数控制。
  • 邮箱
  • 通讯组或启用邮件的安全组(所有邮箱当前都是组成员)。

若要指定邮箱或通讯组,请使用电子邮件地址。 可以指定用逗号分隔的多个值。

Update 如果值包含空格或需要引号,请使用以下语法 "Value1","Value2",..."ValueN" : 。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-ExchangeLocationExclusion

此参数仅在本地部署中可用或Exchange。

如果在创建规则后删除该组,则发送到组成员的邮件不会出现异常。

  • 常规用户邮箱。 包括其他类型的邮箱 (例如,非活动邮箱或 Microsoft 365 来宾) 由 AllowNotFoundExchangeLocationsEnabled 参数控制。
  • 邮箱

若要指定邮箱或通讯组,请使用电子邮件地址。 可以指定用逗号分隔的多个值。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Force

Force 开关指定是否取消显示警告或确认消息。您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。您无需使用此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-HoldNames

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

HoldNames 参数指定将搜索电子数据展示案例中已置于保留状态的内容位置。 对此参数使用值 All。 只能将此参数用于与电子数据展示服务案例关联的合规性搜索。

如果合规性搜索中的内容位置包括邮箱,则还需要将 ExchangeLocation 参数与值 $null。 同样,如果合规性搜索包括SharePoint,则还需要将 SharePointLocation 参数与值 $null。

此外,如果内容位置置于基于查询的服务案例的保留状态,则在重新启动此合规性搜索时,只会搜索处于保留状态的项目。例如,如果将用户置于基于查询的服务案例的保留状态,且可保留在特定日期之前发送或创建的项目,则通过使用此合规性搜索指定的搜索条件,可仅对这些项目进行搜索。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Identity

Identity 参数指定要修改的合规性搜索。

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

  • 名称
  • JobRunId (GUID)

JobRunId (GUID)

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-IncludeOrgContent

{{ Fill IncludeOrgContent Description }}

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-IncludeUserAppContent

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

IncludeUserAppContent 参数指定要搜索在基于云的存储位置中查找组织中没有常规 Microsoft 365用户帐户的用户。 这些类型的用户包括没有 Exchange Online 许可证的用户、使用 Office 应用程序的用户、Microsoft 365 来宾用户,以及其身份与 Microsoft 365 组织同步的本地用户。 有效值为:

  • $true:搜索中将包含在任何 Exchange 位置参数中指定的用户的基于云的存储位置。 如果将值 All 用于 ExchangeLocation 参数,则搜索中将包含任何来宾或本地用户的基于云的存储位置。
  • $false:搜索中不会包含 ExchangeLocation 参数中指定的用户的基于云的存储位置。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Language

Language 参数指定合规性搜索的语言。

此参数的有效输入是 Microsoft 或 CultureInfo 类.NET Framework区域性代码值。 例如,da-DK 表示丹麦语,ja-JP 表示日语。 有关详细信息,请参阅 CultureInfo 类

Type:CultureInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Name

保留此参数以供 Microsoft 内部使用。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-PublicFolderLocation

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

PublicFolderLocation 参数指定要在搜索中包括所有公用文件夹。可以对此参数使用值 All。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-RefinerNames

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

保留此参数以供 Microsoft 内部使用。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-RemoveExchangeLocation

GUID

  • 此参数指定了在对 ExchangeLocation 参数使用值 All 时要从已排除邮箱列表中删除的邮箱。有效值为:
  • 邮箱

若要指定邮箱或通讯组,请使用电子邮件地址。 可以指定用逗号分隔的多个值。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-RemoveExchangeLocationExclusion

此参数仅在本地部署中可用或Exchange。

当您对 ExchangeLocation 参数使用值 All 时,此参数指定要从已排除邮箱列表中删除的邮箱。 有效值为:

  • 此参数指定了在对 ExchangeLocation 参数使用值 All 时要从已排除邮箱列表中删除的邮箱。有效值为:
  • 邮箱

若要指定邮箱或通讯组,请使用电子邮件地址。 可以指定用逗号分隔的多个值。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-RemovePublicFolderLocation

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

保留此参数以供 Microsoft 内部使用。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-RemoveSharePointLocation

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

RemoveSharePointLocation 参数指定SharePoint SharePointLocation 参数的值 All 时要从包含的网站列表中删除的联机网站。 可以按 URL 值标识网站。

Update 如果值包含空格或需要引号,请使用以下语法 "Value1","Value2",..."ValueN" : 。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-RemoveSharePointLocationExclusion

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

保留此参数以供 Microsoft 内部使用。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-SharePointLocation

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

SharePointLocation 参数指定要SharePoint的联机网站。 可以按 URL 值标识网站,也可以使用值 All 添加所有网站。

Update 如果值包含空格或需要引号,请使用以下语法 "Value1","Value2",..."ValueN" : 。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-SharePointLocationExclusion

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

保留此参数以供 Microsoft 内部使用。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-WhatIf

WhatIf 开关在安全与合规中心 PowerShell 中不起作用。

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。您无需使用此开关指定值。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center

输入

输出