Clonar una búsqueda de contenido

La creación de una búsqueda de contenido en el portal de cumplimiento Microsoft Purview en Microsoft 365 que busca en muchos buzones de correo o SharePoint y OneDrive para la Empresa sitios puede tardar un tiempo. Especificar los sitios que se van a buscar también puede ser propenso a errores si escribe mal una dirección URL. Para evitar estos problemas, puede usar el script Windows PowerShell de este artículo para clonar rápidamente una búsqueda de contenido existente. Al clonar una búsqueda, se crea una nueva búsqueda (con un nombre diferente) que contiene las mismas propiedades (como las ubicaciones de contenido y la consulta de búsqueda) que la búsqueda original. A continuación, puede editar la nueva búsqueda cambiando la consulta de palabras clave o el intervalo de fechas y ejecútela.

¿Por qué clonar búsquedas de contenido?

  • Para comparar los resultados de diferentes consultas de búsqueda de palabras clave, ejecute en las mismas ubicaciones de contenido.

  • Para evitar que tenga que volver a escribir un gran número de ubicaciones de contenido al crear una nueva búsqueda.

  • Para reducir el tamaño de los resultados de la búsqueda. Por ejemplo, si tiene una búsqueda que devuelve demasiados resultados para exportar, puede clonar la búsqueda y, a continuación, agregar una condición de búsqueda basada en un intervalo de fechas para reducir el número de resultados de búsqueda.

Propina

Si no es cliente de E5, puede probar todas las características premium de Microsoft Purview de forma gratuita. Use la prueba de soluciones de Purview de 90 días para explorar cómo las sólidas funcionalidades de Purview pueden ayudar a su organización a administrar las necesidades de cumplimiento y seguridad de datos. Comience ahora en el centro de pruebas de portal de cumplimiento Microsoft Purview. Obtenga más información sobre los términos de suscripción y evaluación.

Información de script

  • Debe instalar el módulo de PowerShell Exchange Online. Para obtener instrucciones, consulte Instalación y mantenimiento del módulo de PowerShell Exchange Online.

  • Debe ser miembro del grupo de roles administrador de eDiscovery en el portal de cumplimiento Microsoft Purview para ejecutar el script descrito en este tema.

  • El script incluye un control mínimo de errores. El propósito principal del script es clonar rápidamente una búsqueda de contenido.

  • El script crea una nueva búsqueda de contenido, pero no la inicia.

  • Este script tiene en cuenta si la búsqueda de contenido que está clonando está asociada a un caso de exhibición de documentos electrónicos. Si la búsqueda está asociada a un caso, la nueva búsqueda también se asociará con el mismo caso. Si la búsqueda existente no está asociada a un caso, la nueva búsqueda se mostrará en la página Búsqueda de contenido del portal de cumplimiento Microsoft Purview.

  • El script de ejemplo proporcionado en este tema no se admite en ningún programa o servicio de soporte técnico estándar de Microsoft. El script de ejemplo aparece "TAL CUAL", sin garantía de ningún tipo. Además, Microsoft no se hace responsable de cualquier garantía implícita, incluyendo, de manera enunciativa pero no limitativa, cualquier garantía implícita de comercialización o de calidad para cualquier propósito. Cualquier riesgo resultante del uso o rendimiento del script y la documentación de ejemplo será únicamente responsabilidad suya. En ningún caso Microsoft, sus autores o cualquier persona involucrada en su creación, producción o entrega de los scripts será responsable de cualquier daño (incluidos, de manera enunciativa pero no limitativa, daños por pérdidas de beneficios de una empresa, interrupción de la actividad de una empresa, pérdidas de información de una empresa, o cualquier otro daño pecuniario), incluso si Microsoft supiera de la posibilidad de tales daños.

El script de este paso creará una nueva búsqueda de contenido mediante la clonación de una existente. Al ejecutar este script, se le pedirá la siguiente información:

  • Credenciales de usuario : el script usará sus credenciales para conectarse a PowerShell de cumplimiento de seguridad & . Como se indicó anteriormente, debe ser miembro del grupo de roles administrador de exhibición de documentos electrónicos en el portal de cumplimiento Microsoft Purview para ejecutar el script.

  • Nombre de la búsqueda existente : se trata de la búsqueda de contenido que desea clonar.

  • Nombre de la nueva búsqueda que se creará : si deja este valor en blanco, el script creará un nombre para la nueva búsqueda que se basa en el nombre de la búsqueda que va a clonar.

Para clonar una búsqueda:

  1. Guarde el texto siguiente en un archivo de script de Windows PowerShell mediante un sufijo de nombre de archivo de .ps1; por ejemplo, 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. Conexión a la seguridad & PowerShell de cumplimiento. En la misma ventana de PowerShell, vaya a la carpeta donde guardó el script.

  3. Ejecute el script; por ejemplo:

    .\CloneSearch.ps1
    
  4. Escriba la siguiente información cuando el script le solicite. Escriba cada fragmento de información y, a continuación, presione Entrar.

    • Nombre de la búsqueda existente.
    • Nombre de la nueva búsqueda.

    El script crea la nueva búsqueda de contenido, pero no la inicia. Esto le da la oportunidad de editar y ejecutar la búsqueda en el paso siguiente. Para ver las propiedades de la nueva búsqueda, ejecute el cmdlet Get-ComplianceSearch o vaya a la página Búsqueda de contenido o exhibición de documentos electrónicos de la portal de cumplimiento Microsoft Purview, en función de si la nueva búsqueda está asociada a un caso.

Paso 2: Editar y ejecutar la búsqueda clonada en el portal de cumplimiento Microsoft Purview

Después de ejecutar el script para clonar una búsqueda de contenido existente, el siguiente paso es ir al portal de cumplimiento Microsoft Purview para editar y ejecutar la nueva búsqueda. Como se indicó anteriormente, puede editar una búsqueda cambiando la consulta de búsqueda de palabras clave y agregando o quitando condiciones de búsqueda. Para obtener más información, consulte: