Clonar uma Pesquisa de Conteúdo

Cuidado

A Microsoft desativou todas as experiências clássicas de descoberta eletrônica em 31 de agosto de 2025. Essa desativação inclui a Pesquisa de Conteúdo clássica, a Descoberta Eletrônica clássica (Standard) e a Descoberta Eletrônica clássica (Premium).

As diretrizes neste artigo se aplicam apenas a organizações hospedadas no Microsoft 365 operado pela 21Vianet (China). Se sua organização não for hospedada pela 21Vianet, use as orientações para a nova experiência de Descoberta Eletrônica no portal do Microsoft Purview.

Pode demorar um pouco a criação de uma Pesquisa de Conteúdo no portal do Microsoft Purview no Microsoft 365 que pesquisa muitas caixas de correio ou sites do SharePoint e do OneDrive for Business. Especificar os sites a serem pesquisados também pode ser propenso a erros se você digitar incorretamente uma URL. Para evitar esses problemas, você pode usar o script do Windows PowerShell neste artigo para clonar rapidamente uma Pesquisa de Conteúdo existente. Quando você clona uma pesquisa, é criada uma nova pesquisa (com um nome diferente) que contém as mesmas propriedades (como os locais de conteúdo e a consulta de pesquisa) da pesquisa original. Em seguida, você poderá editar a nova pesquisa alterando a consulta de palavra-chave ou o intervalo de datas e executá-la.

Por que clonar pesquisas de conteúdo?

  • Para comparar os resultados de diferentes consultas de pesquisa de palavra-chave, execute nos mesmos locais de conteúdo.

  • Para evitar que você precise reinserir um grande número de locais de conteúdo ao criar uma nova pesquisa.

  • Para diminuir o tamanho dos resultados da pesquisa. Por exemplo, se você tiver uma pesquisa que retorne muitos resultados para exportação, poderá clonar a pesquisa e adicionar uma condição de pesquisa com base em um intervalo de datas para reduzir o número de resultados da pesquisa.

Informações do script

  • Você precisa instalar o módulo do PowerShell do Exchange Online. Para obter instruções, consulte Instalar e manter o módulo do PowerShell do Exchange Online.

  • Você precisa ser membro do grupo de funções Gerenciador de Descoberta Eletrônica no portal do Microsoft Purview para executar o script descrito neste tópico.

  • O script inclui tratamento mínimo de erros. O objetivo principal do script é clonar rapidamente uma pesquisa de conteúdo.

  • O script cria uma nova Pesquisa de Conteúdo, mas não a inicia.

  • Esse script leva em consideração se a Pesquisa de Conteúdo que você está clonando está associada a um caso de Descoberta Eletrônica. Se a pesquisa estiver associada a uma ocorrência, a nova pesquisa também será associada à mesma ocorrência. Se a pesquisa existente não estiver associada a uma ocorrência, a nova pesquisa será listada na página Pesquisa de conteúdo no portal do Microsoft Purview.

  • O script de amostra fornecido neste tópico não tem suporte em nenhum serviço ou programa de suporte padrão da Microsoft. O script de amostra é fornecido COMO ESTÁ, sem garantia de nenhum tipo. A Microsoft também se isenta de todas as garantias implícitas, incluindo, sem limitação, quaisquer garantias implícitas de comercialização ou adequação a uma finalidade específica. Todo o risco decorrente do uso ou desempenho do script de amostra e da documentação permanece com você. De modo algum a Microsoft, seus autores ou qualquer outra pessoa envolvida na criação, produção ou veiculação dos scripts serão considerados responsáveis por quaisquer danos (incluindo sem limitações danos por perda de lucros comerciais, interrupção de negócios, perda de informações comerciais ou outras perdas pecuniárias) resultantes do uso ou da incapacidade de uso da documentação ou scripts de exemplo, mesmo que a Microsoft tenha sido alertada sobre a possibilidade de tais danos.

O script nesta etapa criará uma nova Pesquisa de Conteúdo clonando uma existente. Ao executar esse script, você será solicitado a fornecer as seguintes informações:

  • Suas credenciais de usuário – o script usará suas credenciais para se conectar ao PowerShell de Segurança & Conformidade. Como mencionado anteriormente, você precisa ser membro do grupo de funções Gerente de Descoberta Eletrônica no portal Microsoft Purview para executar o script.

  • O nome da pesquisa existente - Esta é a Pesquisa de Conteúdo que você deseja clonar.

  • O nome da nova pesquisa que será criada – se você deixar esse valor em branco, o script criará um nome para a nova pesquisa com base no nome da pesquisa que você está clonando.

Para clonar uma pesquisa:

  1. Salve o texto a seguir em um arquivo de script de Windows PowerShell usando um sufixo de nome de arquivo de .ps1; por exemplo, 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
}

  2. Conectar-se a Segurança e Conformidade do PowerShell. Na mesma janela do PowerShell, acesse a pasta onde você salvou o script.

  3. Execute o script; Por exemplo:

    .\CloneSearch.ps1

  4. Insira as informações a seguir quando solicitado pelo script. Digite cada informação e pressione Enter.

    • O nome da pesquisa existente.
    • O nome da nova pesquisa.

    O script cria a nova Pesquisa de Conteúdo, mas não a inicia. Isso lhe dá a oportunidade de editar e executar a pesquisa na próxima etapa. Você pode exibir as propriedades da nova pesquisa executando o cmdlet Get-ComplianceSearch ou acessando a página Pesquisa de conteúdo ou Descoberta Eletrônica no portal do Microsoft Purview, dependendo se a nova pesquisa está associada a um caso.

Etapa 2: editar e executar a pesquisa clonada no portal do Microsoft Purview

Depois de executar o script para clonar uma Pesquisa de Conteúdo existente, a próxima etapa é acessar o portal do Microsoft Purview para editar e executar a nova pesquisa. Como dito anteriormente, você pode editar uma pesquisa alterando a consulta de pesquisa de palavra-chave e adicionando ou removendo condições de pesquisa. Para saber mais, confira:

  • Last updated on