克隆内容搜索

项目
12/20/2024

提示

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

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

为什么要克隆内容搜索？

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

提示

如果你不是 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 合规门户编辑并运行新的搜索。如前所述，可以通过更改搜索查询关键字 (keyword) 以及添加或删除搜索条件来编辑搜索。有关更多信息，请参阅：

通过

克隆内容搜索

脚本信息

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

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

反馈

其他资源