Usar la búsqueda de contenido en Office 365 para colecciones de destinadas

Importante:  Este artículo se ha traducido con traducción automática; vea la declinación de responsabilidades. Para su referencia, puede encontrar la versión en inglés de este artículo aquí.

La característica de búsqueda de contenido en el Centro de cumplimiento y seguridad de Office 365 no proporciona una manera directa en la interfaz de usuario para buscar carpetas específicas en Exchange buzones o sitios SharePoint y OneDrive para la Empresa. Sin embargo, es posible buscar carpetas específicas (denominadas una colección de destino) especificando el identificador de la carpeta o la ruta en la sintaxis de la consulta de búsqueda. Uso de la búsqueda de contenido para realizar una colección de destino es útil cuando esté seguro de que se encuentran los elementos responde a un caso o con privilegios de elementos en una carpeta de buzón de correo o sitios específica. Puede utilizar la secuencia de comandos de este artículo para obtener el identificador de carpeta para las carpetas del buzón de correo o la ruta de acceso para las carpetas en un sitio de SharePoint y OneDrive para la Empresa. A continuación, puede usar el identificador de la carpeta o la ruta de una consulta de búsqueda para devolver elementos que se encuentran en la carpeta.

Estos son los pasos para que esto suceda:

Paso 1: Ejecute la secuencia de comandos para obtener una lista de carpetas para un buzón de correo o un sitio

Paso 2: Usar un identificador de la carpeta o la ruta de acceso para realizar una colección de destino

Más información

Antes de comenzar

  • Debe ser miembro del grupo de roles Administrador de exhibición de documentos electrónicos en la Centro de cumplimiento y seguridad para ejecutar el script en el paso 1. Para obtener más información, vea asignar permisos de exhibición de documentos electrónicos en el centro de cumplimiento y la seguridad de Office 365.

    Además, debe tener asignado el rol de los destinatarios de correo de su organización Exchange Online. Esto es necesario para ejecutar el cmdlet Get-MailboxFolderStatistics , que se incluye en la secuencia de comandos en el paso 1. De forma predeterminada, la función de los destinatarios de correo se asigna a los grupos de funciones de administración de la organización y administración de destinatarios en Exchange Online. Para obtener más información sobre cómo asignar permisos en Exchange Online, vea administrar los miembros del grupo de roles. Podría también crear un grupo de roles personalizados, asignar el rol de los destinatarios de correo a él y, a continuación, agregue a los miembros que necesitan para ejecutar la secuencia de comandos en el paso 1. Para obtener más información, vea Administrar grupos de roles.

  • Cada vez que ejecute la secuencia de comandos en el paso 1, se crea una nueva sesión remota de PowerShell. Así se puede usar el todas las remote PowerShell sesiones disponibles. Para evitar esto, puede ejecutar el comando siguiente para desconectar las sesiones de PowerShell remotas activas.

    Get-PSSession | Remove-PSSession

    Para obtener más información, vea conectarse a Exchange Online PowerShell.

  • La secuencia de comandos incluye control de errores mínima. Es la finalidad principal de la secuencia de comandos mostrar una lista de carpetas del buzón identificadores o rutas de acceso que se pueden usar para realizar una colección de destino en la sintaxis de la consulta de búsqueda de una búsqueda de contenido del sitio rápidamente.

  • La secuencia de comandos de muestra proporcionado en este tema no es compatible con ningún servicio o programa de soporte estándar de Microsoft. La secuencia de comandos de ejemplo se proporciona tal cual sin ninguna garantía. Microsoft renuncia a todas las garantías implícitas incluyendo, sin limitación, cualquier garantía de comerciabilidad o idoneidad para un propósito particular implícita. Todos los riesgos derivados de la utilización o el rendimiento de la secuencia de comandos y la documentación permanece con usted. En ningún caso serán Microsoft, sus autores, o cualquier otra persona implicados en la creación, producción, o entrega las secuencias de ser responsable de daños índole (incluidos, sin limitación, daños por pérdida de beneficios empresariales, interrupción del negocio, pérdida de información empresarial u otras pérdidas de carácter económico) derivadas del uso o no puede usar los scripts de ejemplo o la documentación, aunque Microsoft tenga constancia de la posibilidad de dichos daños.

Volver al principio

Paso 1: Ejecute la secuencia de comandos para obtener una lista de carpetas para un buzón de correo o un sitio

La secuencia de comandos que se ejecutan en este primer paso devolverá una lista de carpetas del buzón o carpetas SharePoint o OneDrive para la Empresa y el ID de carpeta correspondiente o la ruta de acceso para cada carpeta. Cuando se ejecuta esta secuencia de comandos, le pedirá la siguiente información.

  • Dirección URL del sitio o la dirección de correo electrónico    Escriba una dirección de correo electrónico de la custodia para devolver una lista de Exchange carpetas del buzón y doblar identificadores. O bien, escriba la dirección URL para un sitio de SharePoint o un sitio de OneDrive para la Empresa para devolver una lista de rutas de acceso para el sitio especificado. Estos son algunos ejemplos:

    • Exchange   stacig@contoso.onmicrosoft.com

    • SharePoint   https://contoso.sharepoint.com/sites/marketing

    • OneDrive para la Empresa   https://contoso-my.sharepoint.com/personal/stacig_contoso_onmicrosoft_com

  • Las credenciales de usuario    La secuencia de comandos utilizará sus credenciales para conectarse a Exchange Online y la Centro de cumplimiento y seguridad con PowerShell remoto. Como se explica anteriormente, debe asignar los permisos adecuados para poder ejecutar correctamente esta secuencia de comandos.

Para mostrar una lista de carpetas del buzón de correo o nombres de ruta de acceso del sitio:

  1. Guardar el texto siguiente en un archivo de script de Windows PowerShell mediante un sufijo nombre de archivo. ps1; Por ejemplo, GetFolderSearchParameters.ps1.

    #########################################################################################################
    # This PowerShell script will prompt you for:								#
    #    * Admin credentials for a user who can run the Get-MailboxFolderStatistics cmdlet in Exchange	#
    #      Online and who is an eDiscovery Manager in the Security & Compliance Center.			#
    # The script will then:											#
    #    * If an email address is supplied: list the folders for the target mailbox.			#
    #    * If a SharePoint or OneDrive for Business site is supplied: list the folder paths for the site.	#
    #    * In both cases, the script supplies the correct search properties (folderid: or path:)		#
    #      appeneded to the folder ID or path ID to use in a Content Search.				#
    # Notes:												#
    #    * For SharePoint and OneDrive for Business, the paths are searched recursively; this means the 	#
    #      the current folder and all sub-folders are searched.						#
    #    * For Exchange, only the specified folder will be searched; this means sub-folders in the folder	#
    #      will not be searched.  To search sub-folders, you need to use the specify the folder ID for	#
    #      each sub-folder that you want to search.								#
    #    * For Exchange, only folders in the user's primary mailbox will be returned by the script.		#
    #########################################################################################################
    
    # Collect the target email address or SharePoint Url
    $addressOrSite = Read-Host "Enter an email address or a URL for a SharePoint or OneDrive for Business site"
    
    # Authenticate with Exchange Online and the Security & Complaince Center (Exchange Online Protection - EOP)
    if (!$credentials)
    {
        $credentials = Get-Credential
    }
    
    if ($addressOrSite.IndexOf("@") -ige 0)
    {
        # List the folder Ids for the target mailbox
        $emailAddress = $addressOrSite
    
        # Authenticate with Exchange Online
        if (!$ExoSession)
        {
            $ExoSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell-liveid/ -Credential $credentials -Authentication Basic -AllowRedirection
            Import-PSSession $ExoSession -AllowClobber -DisableNameChecking
        }
    
        $folderQueries = @()
        $folderStatistics = Get-MailboxFolderStatistics $emailAddress
        foreach ($folderStatistic in $folderStatistics)
        {
            $folderId = $folderStatistic.FolderId;
            $folderPath = $folderStatistic.FolderPath;
    
            $encoding= [System.Text.Encoding]::GetEncoding("us-ascii")
            $nibbler= $encoding.GetBytes("0123456789ABCDEF");
            $folderIdBytes = [Convert]::FromBase64String($folderId);
            $indexIdBytes = New-Object byte[] 48;
            $indexIdIdx=0;
            $folderIdBytes | select -skip 23 -First 24 | %{$indexIdBytes[$indexIdIdx++]=$nibbler[$_ -shr 4];$indexIdBytes[$indexIdIdx++]=$nibbler[$_ -band 0xF]}
            $folderQuery = "folderid:$($encoding.GetString($indexIdBytes))";
    
            $folderStat = New-Object PSObject
            Add-Member -InputObject $folderStat -MemberType NoteProperty -Name FolderPath -Value $folderPath
            Add-Member -InputObject $folderStat -MemberType NoteProperty -Name FolderQuery -Value $folderQuery
    
            $folderQueries += $folderStat
        }
        Write-Host "-----Exchange Folders-----"
        $folderQueries |ft
    }
    elseif ($addressOrSite.IndexOf("http") -ige 0)
    {
        $searchName = "SPFoldersSearch"
        $searchActionName = "SPFoldersSearch_Preview"
    
        # List the folders for the SharePoint or OneDrive for Business Site
        $siteUrl = $addressOrSite
    
        # Authenticate with the Security & Complaince Center
        if (!$SccSession)
        {
            $SccSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.compliance.protection.outlook.com/powershell-liveid -Credential $credentials -Authentication Basic -AllowRedirection
            Import-PSSession $SccSession -AllowClobber -DisableNameChecking
        }
    
        # Clean-up, if the the script was aborted, the search we created might not have been deleted.  Try to do so now.
        Remove-ComplianceSearch $searchName -Confirm:$false -ErrorAction 'SilentlyContinue'
    
        # Create a Content Search against the SharePoint Site or OneDrive for Business site and only search for folders; wait for the search to complete
        $complianceSearch = New-ComplianceSearch -Name $searchName -ContentMatchQuery "contenttype:folder" -SharePointLocation $siteUrl
        Start-ComplianceSearch $searchName
        do{
            Write-host "Waiting for search to complete..."
            Start-Sleep -s 5
            $complianceSearch = Get-ComplianceSearch $searchName
        }while ($complianceSearch.Status -ne 'Completed')
    
    
        if ($complianceSearch.Items -gt 0)
        {
            # Create a Complinace Search Action and wait for it to complete. The folders will be listed in the .Results parameter
            $complianceSearchAction = New-ComplianceSearchAction -SearchName $searchName -Preview
            do
            {
                Write-host "Waiting for search action to complete..."
                Start-Sleep -s 5
                $complianceSearchAction = Get-ComplianceSearchAction $searchActionName
            }while ($complianceSearchAction.Status -ne 'Completed')
    
            # Get the results and print out the folders
            $results = $complianceSearchAction.Results
            $matches = Select-String "Data Link:.+[,}]" -Input $results -AllMatches
            foreach ($match in $matches.Matches)
            {
                $rawUrl = $match.Value
                $rawUrl = $rawUrl -replace "Data Link: " -replace "," -replace "}"
                Write-Host "path:""$rawUrl"""
            }
        }
        else
        {
            Write-Host "No folders were found for $siteUrl"
        }
    
        Remove-ComplianceSearch $searchName -Confirm:$false -ErrorAction 'SilentlyContinue'
    }
    else
    {
        Write-Error "Couldn't recognize $addressOrSite as an email address or a site URL"
    }
  2. En el equipo local, abra Windows PowerShell y vaya a la carpeta donde guardó la secuencia de comandos.

  3. Ejecute el script; Por ejemplo:

    .\GetFolderSearchParameters.ps1
  4. Escriba la información que se le pedirá la secuencia de comandos.

    La secuencia de comandos muestra una lista de carpetas del buzón o una carpeta de sitio para el usuario especificado. Permitir que esta ventana Abrir para que pueda copiar un nombre de identificador o la ruta de acceso de la carpeta y péguelo en una consulta de búsqueda en el paso 2.

    Sugerencia: En lugar de mostrar una lista de carpetas en la pantalla del equipo, puede volver a dirigir la salida de la secuencia de comandos de un archivo de texto. Este archivo se guardará en la carpeta donde se encuentra la secuencia de comandos. Por ejemplo, para redirigir el script de salida a un archivo de texto, ejecute el comando siguiente en el paso 3: .\GetFolderSearchParameters.ps1 > StacigFolderIds.txt , a continuación, puede copiar un identificador de la carpeta o la ruta de acceso del archivo para usar en una consulta de búsqueda.

Volver al principio

Resultado de la secuencia de comandos para carpetas del buzón

Si recibe identificadores de carpeta del buzón, la secuencia de comandos se conecta a Exchange Online mediante PowerShell remoto, ejecuta el cmdlet Get-MailboxFolderStatisics y, a continuación, muestra la lista de las carpetas del buzón de correo especificada. Para todas las carpetas en el buzón, la secuencia de comandos muestra el nombre de la carpeta en la columna FolderPath y el identificador de la carpeta en la columna FolderQuery . Además, la secuencia de comandos agrega el prefijo de ID carpeta (que es el nombre de la propiedad del buzón) para el identificador de carpeta. Porque la propiedad ID carpeta es una búsqueda, deberá usar folderid:<folderid> en una consulta de búsqueda en el paso 2 para buscar esa carpeta.

Aquí es un ejemplo del resultado devuelto por la secuencia de comandos para las carpetas del buzón.

Ejemplo de la lista de carpetas del buzón y la carpeta identificadores devueltos por la secuencia de comandos

El ejemplo en el paso 2 muestra la consulta usada para buscar la subcarpeta de purga en la carpeta del usuario elementos recuperables.

Salida de secuencia de comandos para las carpetas de sitio

Si recibe rutas de acceso de los sitios SharePoint o OneDrive para la Empresa, la secuencia de comandos se conecta a la Centro de cumplimiento y seguridad con PowerShell remoto, se crea una nueva búsqueda de contenido que busca en el sitio de carpetas y, a continuación, se muestra una lista de las carpetas que se encuentra en el sitio especificado. La secuencia de comandos muestra el nombre de cada carpeta y agrega el prefijo de ruta de acceso (que es el nombre de la propiedad del sitio) a la dirección URL de la carpeta. Dado que la propiedad de ruta de acceso es una propiedad que permiten búsqueda, usará path:<path> en una consulta de búsqueda en el paso 2 para esa carpeta de búsqueda.

Aquí es un ejemplo del resultado devuelto por la secuencia de comandos para las carpetas de sitio.

Ejemplo de la lista de nombres de ruta de acceso para las carpetas de sitio devueltos por la secuencia de comandos

Volver al principio

Paso 2: Usar un identificador de la carpeta o la ruta de acceso para realizar una colección de destino

Una vez que ha ejecutado la secuencia de comandos para recopilar una lista de identificadores de la carpeta o rutas de acceso para un usuario específico, el paso siguiente para ir a la Centro de cumplimiento y seguridad y crear una nueva búsqueda de contenido para buscar una carpeta específica. Deberá usar la propiedad folderid:<folderid> o path:<path> en la consulta de búsqueda que se configura en el cuadro de palabra clave de búsqueda de contenido (o como el valor del parámetro ContentMatchQuery si usa el cmdlet New-ComplianceSearch ). Puede combinar la propiedad folderid o path con otros parámetros de búsqueda o las condiciones de búsqueda. Si solo incluye la propiedad folderid o path en la consulta, la búsqueda devolverá todos los elementos que se encuentra en la carpeta especificada.

  1. Vaya a https://protection.office.com.

  2. Inicie sesión en Office 365 mediante la cuenta y las credenciales utilizadas para ejecutar el script en el paso 1.

  3. En el panel izquierdo de la Centro de cumplimiento y seguridad, haga clic en búsqueda e investigación > búsqueda de contenido y, a continuación, haga clic en Icono de agregar de nuevo.

  4. En la página Búsqueda nueva, escriba un nombre para la búsqueda de contenido. Este nombre debe ser único en la organización.

  5. En ¿dónde desea que nosotros para buscar, siga uno de estos procedimientos, en función de si su búsqueda en una carpeta de buzón de correo o una carpeta del sitio:

    • Haga clic en elegir buzones específicos para buscar y, a continuación, agregue el mismo buzón que especificó cuando ejecutó la secuencia de comandos en el paso 1.

      O bien

    • Haga clic en Elegir los sitios específicos para buscar para buscar y, a continuación, agregar la misma dirección URL del sitio que especificó cuando ejecutó la secuencia de comandos en el paso 1.

  6. Haga clic en Siguiente.

  7. En el cuadro de palabra clave de la ¿Qué desea para buscar de la página, el valor de folderid:<folderid> o path:<path> devuelto por la secuencia de comandos en el paso 1 de pegar.

    Por ejemplo, la consulta en la siguiente captura de pantalla buscará cualquier elemento de la subcarpeta de purga en la carpeta del usuario elementos recuperables desde la captura de pantalla de las carpetas de buzón que se muestra en el paso 1.

    Pegue el ID carpeta o la ruta de acceso en el cuadro de palabra clave de la consulta de búsqueda
  8. Haga clic en Buscar para iniciar la búsqueda de la colección de destino.

Volver al principio

Ejemplos de consultas de búsqueda para colecciones de destinadas

Estos son algunos ejemplos de uso de las propiedades folderid y path en una consulta para realizar una colección de destino. Tenga en cuenta que se usan los marcadores de posición para folderid:<folderid> y path:<path> para ahorrar espacio.

  • Este ejemplo busca tres carpetas de buzones diferentes. Puede usar una sintaxis similar de consulta para buscar las carpetas ocultas en la carpeta de elementos recuperables de un usuario.

    folderid:<folderid> OR folderid:<folderid> OR folderid:<folderid>
  • Este ejemplo busca en una carpeta de buzón de correo para los elementos que contienen una frase exacta.

    folderid:<folderid> AND "Contoso financial results"
  • Este ejemplo busca en una carpeta del sitio (y todas las subcarpetas) para los documentos que contienen las letras "Confidencialidad" en el título.

    path:<path> AND filename:nda
  • Este ejemplo busca una carpeta del sitio (y todas las subcarpetas) se han cambiado los documentos dentro de un intervalo de fechas.

    path:<path> AND (lastmodifiedtime>=01/01/2017 AND lastmodifiedtime<=01/21/2017)

Volver al principio

Más información

Tenga en cuenta lo siguiente cuando con la secuencia de comandos de este artículo y la realización de las colecciones de destino.

  • La secuencia de comandos no elimina todas las carpetas de los resultados. Para algunas carpetas que aparece en los resultados podrían ser unsearchable (o devolver cero elementos) porque contienen contenido generado por el sistema.

  • Esta secuencia de comandos sólo devuelve información de la carpeta para el buzón del usuario principal. No devuelve información acerca de las carpetas en el buzón del usuario archivar.

  • Al buscar carpetas del buzón, se buscará en la carpeta especificada (identificada por su propiedad folderid ). No se buscan las subcarpetas. Para buscar las subcarpetas, necesita usar la folderid de la subcarpeta que desee buscar.

  • Al buscar carpetas del sitio, se buscará la carpeta (identificada por su propiedad path ) y todas las subcarpetas.

Volver al principio

Nota: Declinación de responsabilidades de traducción automática: Este artículo se ha traducido con un sistema informático sin intervención humana. Microsoft ofrece estas traducciones automáticas para que los hablantes de otros idiomas distintos del inglés puedan disfrutar del contenido sobre los productos, los servicios y las tecnologías de Microsoft. Puesto que este artículo se ha traducido con traducción automática, es posible que contenga errores de vocabulario, sintaxis o gramática.

Ampliar sus conocimientos
Explorar los cursos
Obtener nuevas características primero
Únase a los participantes de Office Insider

¿Le ha sido útil esta información?

¡Gracias por sus comentarios!

Gracias por sus comentarios. Quizá le interese ponerse en contacto con uno de nuestros agentes de soporte de Office.

×