Clonar uma Pesquisa de Conteúdo

  • Artigo

Criar uma Pesquisa de Conteúdo no portal de conformidade do Microsoft Purview no Microsoft 365 que pesquisa muitas caixas de correio ou sharePoint e OneDrive for Business sites pode demorar um pouco. 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 Windows PowerShell neste artigo para clonar rapidamente uma Pesquisa de Conteúdo existente. Quando você clona uma pesquisa, uma nova pesquisa (com um nome diferente) é criada que contém as mesmas propriedades (como os locais de conteúdo e a consulta de pesquisa) que a pesquisa original. Em seguida, você pode editar a nova pesquisa alterando a consulta palavra-chave ou o intervalo de datas e executá-la.

Por que clonar pesquisas de conteúdo?

  • Para comparar os resultados de diferentes palavra-chave consultas de pesquisa são executadas nos mesmos locais de conteúdo.

  • Para salvá-lo de ter que reentrada em 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.

Dica

Se você não for um cliente E5, use a avaliação de soluções do Microsoft Purview de 90 dias para explorar como recursos adicionais do Purview podem ajudar sua organização a gerenciar as necessidades de segurança e conformidade de dados. Comece agora no hub de avaliações portal de conformidade do Microsoft Purview. Saiba mais sobre os termos de inscrição e avaliação.

Informações de script

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

  • Você precisa ser membro do grupo de funções do eDiscovery Manager no portal de conformidade do Microsoft Purview para executar o script descrito neste tópico.

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

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

  • Esse script leva em conta 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 um caso, a nova pesquisa também estará associada ao mesmo caso. Se a pesquisa existente não estiver associada a um caso, a nova pesquisa será listada na página Pesquisa de conteúdo no portal de conformidade do Microsoft Purview.

  • O script de exemplo fornecido neste tópico não tem suporte em nenhum programa ou serviço 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 este script, você será solicitado a obter as seguintes informações:

  • Suas credenciais de usuário – o script usará suas credenciais para se conectar ao PowerShell de Conformidade do & de Segurança. Conforme indicado anteriormente, você precisa ser membro do grupo de funções do eDiscovery Manager no portal de conformidade do 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 que se baseia no nome da pesquisa que você está clonando.

Para clonar uma pesquisa:

  1. Salve o texto a seguir em um arquivo de script 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, vá para a pasta em que 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 pedaço de 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 o inicia. Isso lhe dá a chance 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 de conformidade do Microsoft Purview, dependendo se a nova pesquisa está associada a um caso.

Etapa 2: Editar e executar a pesquisa clonada no portal de conformidade do Microsoft Purview

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