克隆内容搜索

项目
07/27/2024

提示

电子数据展示 (预览) 现已在新的 Microsoft Purview 门户中提供。若要详细了解如何使用新的电子数据展示体验，请参阅了解电子数据展示 (预览版) 。

在 Microsoft 365 的 Microsoft Purview 合规门户中创建内容搜索，用于搜索多个邮箱或 SharePoint 和 OneDrive for Business 网站可能需要一段时间。如果键入错误 URL，指定要搜索的网站也容易出错。若要避免这些问题，可以使用本文中的 Windows PowerShell 脚本快速克隆现有内容搜索。克隆搜索时，将创建一个名称不同的新搜索 () ，其中包含与原始搜索相同的属性 (，例如内容位置和搜索查询) 。然后，可以通过更改关键字查询或日期范围来编辑新搜索，然后运行它。

为什么要克隆内容搜索？

若要比较不同关键字的结果，请在相同的内容位置运行搜索查询。
为了避免在创建新搜索时必须重新输入大量内容位置。
减小搜索结果的大小。例如，如果搜索返回的结果太多，无法导出，则可以克隆搜索，然后根据日期范围添加搜索条件，以减少搜索结果的数量。

提示

如果你不是 E5 客户，请使用 90 天Microsoft Purview 解决方案试用版来探索其他 Purview 功能如何帮助组织管理数据安全性和合规性需求。立即从 Microsoft Purview 合规性门户试用中心开始。了解有关注册和试用条款的详细信息。

脚本信息

需要安装 Exchange Online PowerShell 模块。有关说明，请参阅安装和维护 Exchange Online PowerShell 模块。
你必须是 Microsoft Purview 合规性门户中电子数据展示管理器角色组的成员，才能运行本主题中所述的脚本。
该脚本包含最少的错误处理。脚本的主要用途是快速克隆内容搜索。
该脚本会创建新的内容搜索，但不会启动它。
此脚本考虑要克隆的内容搜索是否与电子数据展示案例相关联。如果搜索与事例相关联，则新搜索也将与同一事例相关联。如果现有搜索未与案例关联，则新搜索将在 Microsoft Purview 合规性门户的 “内容搜索 ”页上列出。
任何Microsoft标准支持计划或服务都不支持本主题中提供的示例脚本。示例脚本“原样”提供，不提供任何形式的保证。 Microsoft 进一步拒绝所有默示保证，包括但不限于针对特定用途的适销性或适用性的任何默示保证。由于示例脚本及文档的使用或性能所引起的全部风险均由你承担。在任何情况下，对于由于使用或者无法使用示例脚本或文档所引起的任何损失（包括但不限于商业利润损失、业务中断、商业信息丢失或者其他经济损失），Microsoft、其作者或者参与创建、制作或交付脚本的任何人概不负责，即使 Microsoft 已被告知可能会出现此类损失。

步骤 1：运行脚本以克隆搜索

此步骤中的脚本将通过克隆现有内容搜索来创建新的内容搜索。运行此脚本时，系统会提示输入以下信息：

用户凭据 - 脚本将使用凭据连接到安全性 & 合规性 PowerShell。如前所述，你必须是 Microsoft Purview 合规性门户中电子数据展示管理员角色组的成员才能运行脚本。
现有搜索的名称 - 这是要克隆的内容搜索。
要创建的新搜索的名称 - 如果将此值留空，脚本将根据要克隆的搜索的名称为新搜索创建一个名称。

克隆搜索：

使用文件名后缀 .ps1 将以下文本保存到 Windows PowerShell 脚本文件;例如。 CloneSearch.ps1

# This PowerShell script clones an existing content search in Microsoft Purview compliance.

# Ask for the name of the search you want to clone
$searchName = Read-Host 'Enter the name of the search that you want to clone'
# Ask for the name of the new search
$newSearchName = Read-Host 'Enter a name for the new search [leave blank to automatically generate a name]'
$originalSearch = Get-ComplianceSearch $searchName -EA SilentlyContinue
# Make sure we have a valid search before continuing
if(!$originalSearch)
{
    Write-Error "Couldn't find search: $searchName"
    return
}
$searchNameCounter = 1
# Find a suitable name for the new search
while(!$newSearchName)
{
    $newSearchName = $originalSearch.Name + "_" + $searchNameCounter
    $tempSearch = Get-ComplianceSearch $newSearchName -EA SilentlyContinue
    if ($tempSearch)
    {
        $newSearchName = $null
        $searchNameCounter++
    }
}
$caseName
# Determine if the search is part of a case; if so get the case name
if ($originalSearch.CaseId)
{
    $searchCase = Get-ComplianceCase $originalSearch.CaseId
    $caseName = $searchCase.Name
}
# Need to cast this value as a Boolean the old fashion way
$allowNotFoundExchangeLocationsEnabled = $false
if ($originalSearch.AllowNotFoundExchangeLocationsEnabled)
{
    $allowNotFoundExchangeLocationsEnabled = $true
}
$newSearch = New-ComplianceSearch -Name $newSearchName -AllowNotFoundExchangeLocationsEnabled $allowNotFoundExchangeLocationsEnabled -Case $caseName -ContentMatchQuery $originalSearch.ContentMatchQuery -Description $originalSearch.Description -ExchangeLocation $originalSearch.ExchangeLocation -ExchangeLocationExclusion $originalSearch.ExchangeLocationExclusion -Language $originalSearch.Language -SharePointLocation $originalSearch.SharePointLocation -SharePointLocationExclusion $originalSearch.SharePointLocationExclusion -PublicFolderLocation $originalSearch.PublicFolderLocation
if ($newSearch)
{
    Write-Host $newSearch.Name "was successfully created" -ForegroundColor Yellow
}

连接到安全与合规 PowerShell。在同一 PowerShell 窗口中，转到保存脚本的文件夹。
运行脚本;例如：
```
.\CloneSearch.ps1
```
在脚本提示时输入以下信息。键入每条信息，然后按 Enter。
- 现有搜索的名称。
- 新搜索的名称。
该脚本会创建新的内容搜索，但不会启动它。这让你有机会在下一步中编辑和运行搜索。可以通过运行 Get-ComplianceSearch cmdlet 或转到 Microsoft Purview 合规性门户中 的内容搜索 或 电子数据展示 页来查看新搜索的属性，具体取决于新搜索是否与事例相关联。

步骤 2：在 Microsoft Purview 合规性门户中编辑并运行克隆的搜索

运行脚本克隆现有内容搜索后，下一步是转到 Microsoft Purview 合规性门户以编辑和运行新的搜索。如前所述，可以通过更改关键字搜索查询并添加或删除搜索条件来编辑搜索。有关更多信息，请参阅：

通过

克隆内容搜索

脚本信息

步骤 1：运行脚本以克隆搜索

步骤 2：在 Microsoft Purview 合规性门户中编辑并运行克隆的搜索

反馈

其他资源