Clonar una búsqueda de contenido

  • Artículo

La creación de un Búsqueda de contenido en el portal de cumplimiento Microsoft Purview de 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.

Sugerencia

Si no es cliente de E5, use la prueba de 90 días de soluciones de Microsoft Purview para explorar cómo las funcionalidades adicionales de Purview pueden ayudar a su organización a administrar las necesidades de cumplimiento y seguridad de los datos. Comience ahora en el centro de pruebas del portal de cumplimiento de Microsoft Purview. Obtenga más información sobre términos de suscripción y prueba.

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 un nuevo Búsqueda de contenido, pero no lo inicia.

  • Este script tiene en cuenta si el Búsqueda de contenido que está clonando está asociado a un caso de eDiscovery. 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á un nuevo Búsqueda de contenido mediante la clonación de uno 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: este es el 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. Conéctese al PowerShell de Seguridad y 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 el nuevo Búsqueda de contenido, pero no lo 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: