Usar a pesquisa de conteúdo no Office 365 para conjuntos de destino

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

O recurso de pesquisa de conteúdo na Centro de Conformidade e Segurança do Office 365 não oferece uma maneira direta na interface de usuário para pesquisar pastas específicas na Exchange caixas de correio ou sites SharePoint e OneDrive for Business. No entanto, é possível pesquisar pastas específicas (chamadas de uma coleção de destino), especificando o ID da pasta ou o caminho na sintaxe de consulta de pesquisa real. Usando a pesquisa de conteúdo para executar um conjunto de destino é útil quando você estiver certo de que os itens responde a um caso ou itens privilegiados estão localizados em uma pasta específica de caixa de correio ou site. Você pode usar o script neste artigo para obter o ID de pasta para pastas de caixa de correio ou o caminho para pastas em um site SharePoint e OneDrive for Business. Você pode usar o ID da pasta ou o caminho em uma consulta de pesquisa para retornar itens localizados na pasta.

Aqui estão as etapas para fazer isso:

Etapa 1: Executar o script para obter uma lista de pastas para um site ou uma caixa de correio

Etapa 2: Usar uma ID da pasta ou o caminho para executar um conjunto de destino

Mais informações

Antes de começar

  • Você precisa ser um membro do grupo descoberta eletrônica Manager função no Centro de Conformidade e Segurança para executar o script na etapa 1. Para obter mais informações, consulte atribuir permissões de descoberta eletrônica no Centro de conformidade de segurança do Office 365.

    Além disso, você precisa ser atribuído à função de destinatários de email em sua organização de Exchange Online. Isso é necessário para executar o cmdlet Get-MailboxFolderStatistics , que está incluído no script na etapa 1. Por padrão, a função de destinatários de email é atribuída para os grupos de funções de gerenciamento de organização e gerenciamento de destinatário em Exchange Online. Para obter mais informações sobre como atribuir permissões em Exchange Online, consulte Gerenciar membros do grupo de função. Você pode também criar um grupo de função personalizada, atribuir a função de destinatários de email-lo e, em seguida, adicionar os membros que precisam para executar o script na etapa 1. Para obter mais informações, consulte Gerenciar grupos de função.

  • Sempre que você executar o script na etapa 1, uma nova sessão remota do PowerShell é criada. Portanto, você pode usar para cima todas as remota do PowerShell sessões disponíveis para você. Para impedir que isso aconteça, você pode executar o seguinte comando desconectar seu sessões PowerShell remotas ativas.

    Get-PSSession | Remove-PSSession

    Para obter mais informações, consulte conectar ao Exchange Online PowerShell.

  • O script inclui tratamento de erro mínimo. A principal finalidade do script é exibir uma lista de IDs de pasta de caixa de correio ou caminhos que podem ser usados para executar um conjunto de destino na sintaxe de consulta de pesquisa de uma pesquisa de conteúdo de site rapidamente.

  • O script de exemplo fornecido neste tópico não é compatíveis em qualquer serviço ou programa de suporte padrão da Microsoft. O script de exemplo é fornecido como está sem garantia de qualquer tipo. Microsoft também se isenta de todas as garantias implícitas incluindo, sem limitação, qualquer implícitas de comercialização ou fitness para um propósito específico. Todo o risco decorrente do uso ou o desempenho do script de exemplo e da documentação permanece com você. Em nenhum evento deverá Microsoft, seus autores, ou ninguém envolvidos na criação, produção ou entrega dos scripts será responsável por quaisquer danos (incluindo, sem limitação, danos por perda de lucros comerciais, interrupção de negócios, perda de informações comerciais ou outras perdas PECUNIÁRIAS) decorrente do uso ou impossibilidade de usar os scripts de exemplo ou a documentação, mesmo que a Microsoft tenha sido informada da possibilidade de tais danos.

Retornar ao início

Etapa 1: Executar o script para obter uma lista de pastas para um site ou uma caixa de correio

O script que você executa nesta primeira etapa retornará uma lista de pastas de caixa de correio ou pastas SharePoint ou OneDrive for Business e o ID de pasta correspondente ou o caminho para cada pasta. Quando você executa esse script, ele solicitará que você as seguintes informações.

  • URL de site ou endereço de email    Digite um endereço de email do dos responsáveis retornar uma lista de Exchange pastas de caixa de correio e dobrar IDs. Ou digite a URL para um site de SharePoint ou um site de OneDrive for Business para retornar uma lista de caminhos para o local especificado. Aqui estão alguns exemplos:

    • Exchange   stacig@contoso.onmicrosoft.com

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

    • OneDrive for Business   https://contoso-my.sharepoint.com/personal/stacig_contoso_onmicrosoft_com

  • Suas credenciais de usuário    O script usará suas credenciais para se conectar ao Exchange Online e o Centro de Conformidade e Segurança com o PowerShell remoto. Como explicado anteriormente, você tem as permissões apropriadas para executar este script com êxito.

Para exibir uma lista de pastas de caixa de correio ou nomes de caminho de site:

  1. Salvar o texto a seguir em um arquivo de script Windows PowerShell usando o sufixo filename. ps1; Por exemplo, 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. Em seu computador local, abra Windows PowerShell e vá para a pasta onde você salvou o script.

  3. Execute o script; Por exemplo:

    .\GetFolderSearchParameters.ps1
  4. Insira as informações que o script solicita.

    O script exibe uma lista de pastas de caixa de correio ou pasta de site para o usuário especificado. Permitir que esta janela Abrir para que você pode copiar um nome de identificação ou caminho de pasta e colá-lo em uma consulta de pesquisa na etapa 2.

    Dica : Em vez de exibir uma lista de pastas na tela do computador, você pode direcionar novamente a saída do script para um arquivo de texto. Este arquivo será salvo na pasta onde o script está localizado. Por exemplo, para redirecionar a saída para um arquivo de texto do script, execute o seguinte comando na etapa 3: .\GetFolderSearchParameters.ps1 > StacigFolderIds.txt e em seguida, você pode copiar uma ID da pasta ou um caminho de arquivo a ser usado em uma consulta de pesquisa.

Retornar ao início

Saída de script para pastas de caixa de correio

Se você estiver recebendo IDs de pasta de caixa de correio, o script se conecte a Exchange Online usando o PowerShell remoto, executa o cmdlet Get-MailboxFolderStatisics e, em seguida, exibe a lista das pastas da caixa de correio especificada. Para cada pasta na caixa de correio, o script exibe o nome da pasta na coluna FolderPath e o ID de pasta na coluna FolderQuery . Além disso, o script adiciona o prefixo de folderId (que é o nome da propriedade da caixa de correio) para o ID de pasta. Como o folderid é uma propriedade pesquisável, você usará folderid:<folderid> em uma consulta de pesquisa na etapa 2 para pesquisar nessa pasta.

Aqui está um exemplo da saída retornado pelo script para pastas de caixa de correio.

Exemplo de lista de pastas de caixa de correio e pasta IDs retornados pelo script

O exemplo na etapa 2 mostra a consulta usada para pesquisar a subpasta de exclusão de pasta de itens recuperáveis do usuário.

Saída de script para pastas de site

Se você estiver recebendo caminhos de sites SharePoint ou OneDrive for Business, o script conecta-se ao Centro de Conformidade e Segurança usando o PowerShell remoto, cria uma nova pesquisa de conteúdo que o site para pastas de pesquisa e, em seguida, exibe uma lista das pastas localizado no site especificado. O script exibe o nome de cada pasta e adiciona o prefixo de caminho (que é o nome da propriedade site) para a URL de pasta. Como o caminho é uma propriedade pesquisável, você usará path:<path> em uma consulta de pesquisa na etapa 2 para pesquisar nessa pasta.

Aqui está um exemplo da saída retornado pelo script para pastas de site.

Exemplo de lista de nomes de caminho retornado pelo script de pastas de site

Retornar ao início

Etapa 2: Usar uma ID da pasta ou o caminho para executar um conjunto de destino

Depois de ter executado o script para coletar uma lista de IDs de pasta ou caminhos para um usuário específico, a próxima etapa para ir para o Centro de Conformidade e Segurança e crie uma nova pesquisa de conteúdo para pesquisar uma pasta específica. Você usará a propriedade folderid:<folderid> ou path:<path> na consulta de pesquisa que você configurar na caixa de palavra-chave de pesquisa de conteúdo (ou como o valor para o parâmetro ContentMatchQuery se você usar o cmdlet New-ComplianceSearch ). Você pode combinar a propriedade folderid ou path com outros parâmetros de pesquisa ou critérios de pesquisa. Se você incluir apenas a propriedade folderid ou path na consulta, a pesquisa retornará todos os itens localizados na pasta especificada.

  1. Acesse https://protection.office.com.

  2. Entrar no Office 365 usando a conta e as credenciais que você usou para executar o script na etapa 1.

  3. No painel esquerdo da Centro de Conformidade e Segurança, clique em pesquisa e investigação > pesquisa de conteúdo e clique em novo Ícone Adicionar .

  4. Na página Nova pesquisa, digite um nome para a Pesquisa de Conteúdo. O nome deve ser exclusivo em sua organização.

  5. Em onde você deseja que a aparência, siga um destes procedimentos, com base em se sua pesquisa uma pasta de caixa de correio ou uma pasta do site:

    • Clique em Escolher caixas de correio específicas para pesquisar e adicione a mesma caixa de correio que você especificou quando você executou o script na etapa 1.

      Ou

    • Clique em Escolher sites específicos para pesquisar para pesquisar e, em seguida, adicione a URL do site mesmo que você especificou quando você executou o script na etapa 1.

  6. Clique em Avançar.

  7. Na caixa palavra-chave no que deseja conosco procurá para página, colar um valor folderid:<folderid> ou path:<path> que foi retornado pelo script na etapa 1.

    Por exemplo, a consulta na seguinte captura de tela irá procurar qualquer item na exclusão subpasta na pasta de itens recuperáveis do usuário na caixa de correio pastas captura de tela mostrada na etapa 1.

    Cole o folderid ou o caminho na caixa palavra-chave da consulta de pesquisa
  8. Clique em Pesquisar para iniciar a pesquisa de conjunto de destino.

Retornar ao início

Exemplos de consultas de pesquisa para conjuntos de destino

Aqui estão alguns exemplo de como usar as propriedades folderid e path em uma consulta para executar um conjunto de destino. Observe que espaços reservados são usados para folderid:<folderid> e path:<path> para economizar espaço.

  • Este exemplo procura três pastas de caixas de correio diferente. Você pode usar uma sintaxe de consulta semelhante para pesquisar as pastas ocultas na pasta de itens recuperáveis de um usuário.

    folderid:<folderid> OR folderid:<folderid> OR folderid:<folderid>
  • Este exemplo procura uma pasta de caixa de correio para itens que contêm uma frase exata.

    folderid:<folderid> AND "Contoso financial results"
  • Este exemplo procura uma pasta do site (e qualquer subpasta) documentos que contêm as letras "Divulgação" no título.

    path:<path> AND filename:nda
  • Este exemplo procura uma pasta do site (e qualquer subpasta) documentos foram alterados de um intervalo de datas.

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

Retornar ao início

Mais informações

Tenha os seguintes itens em mente ao usar o script neste artigo e realizando direcionadas conjuntos.

  • O script não remove quaisquer pastas dos resultados. Para que algumas pastas listadas nos resultados podem ser não pesquisável (ou retornar zero itens) porque eles contêm conteúdo geradas pelo sistema.

  • Esse script retorna somente informações de pasta para a caixa de correio principal do usuário. Ela não retorne informações sobre pastas na caixa de correio de arquivo morto do usuário.

  • Ao pesquisar pastas de caixa de correio, somente a pasta especificada (identificada por sua propriedade folderid ) será pesquisada. As subpastas não ser pesquisadas. Para Pesquisar subpastas, você precisa usar o folderid para a subpasta que você deseja pesquisar.

  • Ao pesquisar pastas do site, a pasta (identificado por sua propriedade path ) e todas as subpastas serão pesquisadas.

Retornar ao início

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×