Clonar uma Pesquisa de Conteúdo

Criar uma Pesquisa de Conteúdo no portal de conformidade do Microsoft Purview no Microsoft 365 que pesquisa muitas caixas de correio ou sites do SharePoint e OneDrive for Business pode demorar um pouco. Especificar os sites a serem pesquisados também poderá 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, é 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) que a pesquisa original. Em seguida, você pode editar a nova pesquisa alterando a consulta de palavra-chave ou o intervalo de datas e executando-a.

Por que clonar Pesquisas de Conteúdo?

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

  • Para que você não 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.

Ponta

Se você não for um cliente E5, poderá experimentar todos os recursos premium do Microsoft Purview gratuitamente. Use a avaliação de soluções do Purview de 90 dias para explorar como os recursos robustos do Purview podem ajudar sua organização a gerenciar as necessidades de conformidade e segurança de dados. Comece agora no portal de conformidade do Microsoft Purview de avaliações. Saiba mais sobre como inscrever-se e os termos de avaliação.

Informações do 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 Gerenciador de Descoberta Eletrônica no portal de conformidade do Microsoft Purview para executar o script descrito neste tópico.

  • O script inclui 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 a 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 será associada ao mesmo caso. Se a pesquisa existente não estiver associada a um caso, a nova pesquisa será listada na página De 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 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 & Conformidade de Segurança. Conforme mencionado anteriormente, você precisa ser um membro do grupo de funções do Gerenciador de Descoberta Eletrônica 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 Windows PowerShell de script 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 à Segurança & PowerShell de conformidade. 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 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 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 indo para 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 para o portal de conformidade do Microsoft Purview editar e executar a nova pesquisa. Conforme mencionado 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, veja: