Partilhar via

Clonar uma Pesquisa de Conteúdo

  • Artigo

Dica

A Deteção de Dados Eletrónicos (pré-visualização) está agora disponível no novo portal do Microsoft Purview. Para saber mais sobre como utilizar a nova experiência de Deteção de Dados Eletrónicos, veja Saiba mais sobre a Deteção de Dados Eletrónicos (pré-visualização).

A criação de uma Pesquisa de Conteúdos no portal de conformidade do Microsoft Purview no Microsoft 365 que pesquisa em muitas caixas de correio ou sites do SharePoint e do OneDrive para Empresas pode demorar algum tempo. Especificar os sites a pesquisar também pode ser propenso a erros se escrever um URL incorretamente. Para evitar estes problemas, pode utilizar o script do Windows PowerShell neste artigo para clonar rapidamente uma Pesquisa de Conteúdos existente. Quando clona uma pesquisa, é criada uma nova pesquisa (com um nome diferente) que contém as mesmas propriedades (como as localizações de conteúdo e a consulta de pesquisa) que a pesquisa original. Em seguida, pode editar a nova pesquisa ao alterar a consulta de palavra-chave ou o intervalo de datas e executá-la.

Porquê clonar Pesquisas de Conteúdo?

  • Para comparar os resultados de diferentes consultas de pesquisa de palavras-chave, execute nas mesmas localizações de conteúdo.

  • Para evitar que tenha de reintroduzir um grande número de localizações de conteúdo quando cria 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 é um cliente E5, use a avaliação das soluções do Microsoft Purview de 90 dias para explorar como os 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 testes do portal de conformidade do Microsoft Purview. Saiba mais detalhes sobre os termos de inscrição e avaliação.

Informações do script

  • Tem de 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.

  • Tem de ser membro do grupo de funções Gestor de Deteção de Dados Eletrónicos no portal de conformidade do Microsoft Purview para executar o script descrito neste tópico.

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

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

  • Este script tem em conta se a Pesquisa de Conteúdos que está a clonar está associada a um caso de Deteção de Dados Eletrónicos. Se a pesquisa estiver associada a um caso, a nova pesquisa também será 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údos no portal de conformidade do Microsoft Purview.

  • O script de exemplo fornecido neste tópico não é suportado 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 neste passo irá criar uma nova Pesquisa de Conteúdos ao clonar uma existente. Quando executar este script, ser-lhe-ão pedidas as seguintes informações:

  • As suas credenciais de utilizador – o script utilizará as suas credenciais para ligar ao PowerShell de Conformidade do & de Segurança. Conforme indicado anteriormente, tem de ser membro do grupo de funções Gestor de Deteção de Dados Eletrónicos no portal de conformidade do Microsoft Purview para executar o script.

  • O nome da pesquisa existente – esta é a Pesquisa de Conteúdo que pretende clonar.

  • O nome da nova pesquisa que será criada – se deixar este valor em branco, o script criará um nome para a nova pesquisa baseada no nome da pesquisa que está a clonar.

Para clonar uma pesquisa:

  1. Guarde o seguinte texto num ficheiro de script do Windows PowerShell com um sufixo de nome de ficheiro 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, aceda à pasta onde guardou o script.

  3. Executar o script; Por exemplo:

    .\CloneSearch.ps1

  4. Introduza as seguintes informações quando lhe for pedido pelo script. Escreva cada informação e, em seguida, prima Enter.

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

    O script cria a nova Pesquisa de Conteúdos, mas não a inicia. Isto dá-lhe a oportunidade de editar e executar a pesquisa no próximo passo. Pode ver as propriedades da nova pesquisa ao executar o cmdlet Get-ComplianceSearch ou ao aceder à página Pesquisa de conteúdos ou Deteção de Dados Eletrónicos no portal de conformidade do Microsoft Purview, consoante a nova pesquisa esteja associada a um caso.

Passo 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údos existente, o passo seguinte é aceder ao portal de conformidade do Microsoft Purview para editar e executar a nova pesquisa. Conforme indicado anteriormente, pode editar uma pesquisa ao alterar a consulta de pesquisa de palavras-chave e adicionar ou remover condições de pesquisa. Para saber mais, confira: