Use a pesquisa de conteúdo para procurar a caixa de correio e o OneDrive site de negócios para uma lista de usuários

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 Office 365 Centro de Conformidade e Segurança fornece um número de cmdlets Windows PowerShell que permitem automatizar tarefas relacionadas a descoberta eletrônica demoradas. Atualmente, a criação de uma pesquisa de conteúdo no Centro de Conformidade e Segurança para pesquisar um grande número de locais de conteúdo dos responsáveis leva tempo e preparação. Antes de criar uma pesquisa, você precisa coletar a URL para cada site OneDrive for Business e, em seguida, adicionar cada site de correio e OneDrive for Business à pesquisa. Em futuras versões, será mais fácil de fazer na Centro de Conformidade e Segurança. Até lá, você pode usar o script neste artigo para automatizar esse processo. Esse script solicita o nome de domínio de meusite da sua organização (por exemplo, contoso na URL https://contoso-my.sharepoint.com), uma lista de endereços de email do usuário, o nome da nova pesquisa de conteúdo e a consulta de pesquisa para usar. O script obtém a URL de OneDrive for Business para cada usuário na lista e, em seguida, ele cria e inicia uma pesquisa de conteúdo que procura o site de correio e OneDrive for Business para cada usuário na lista, usando a consulta de pesquisa que você fornecer.

Aqui estão as etapas para fazer isso:

Etapa 1: Instalar o Shell de gerenciamento on-line do SharePoint

Etapa 2: Gerar uma lista de usuários

Etapa 3: Executar o script para criar e iniciar a pesquisa

Antes de começar

  • Você precisa ser um membro do grupo de função do Gerenciador de descoberta eletrônica na Centro de Conformidade e Segurança e um administrador global SharePoint Online para executar o script na etapa 3.

  • Certifique-se de salvar a lista de usuários que você criar na etapa 2 e o script na etapa 3 na mesma pasta. Que irá facilitar executar o script.

  • O script inclui tratamento de erro mínimo. Sua finalidade principal é rapidamente e facilmente pesquisar o site de correio e OneDrive for Business de cada usuário.

  • Os scripts de exemplo fornecidos neste tópico não são compatíveis com nenhum serviço ou programa de suporte padrão da Microsoft. Os scripts de exemplo são fornecidos COMO ESTÃO sem qualquer tipo de garantia. A Microsoft também se isenta de todas as garantias implícitas, incluindo sem limitações quaisquer garantias aplicáveis de padrões de comercialização ou de adequação a uma finalidade específica. Todos os riscos decorrentes do uso ou da execução da documentação ou scripts de exemplo serão de sua responsabilidade. 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.

Etapa 1: Instalar o Shell de gerenciamento de SharePoint Online

A primeira etapa é instalar o SharePoint Online Shell de gerenciamento. Você não precisa usar o shell neste procedimento, mas você precisa instalá-lo porque ele contém pré-requisitos necessários para o script que você executar na etapa 3. Esses pré-requisitos permitem o script para se comunicar com SharePoint Online para obter as URLs para os sites de OneDrive for Business.

Vá para Configurar o ambiente do SharePoint Online Management Shell Windows PowerShell e executar a etapa 1 e a etapa 2 para instalar o SharePoint Online Shell de gerenciamento.

Retornar ao início

Etapa 2: Gerar uma lista de usuários

O script na etapa 3 criará uma pesquisa de conteúdo para pesquisar os sites de OneDrive for Business de uma lista de usuários e caixas de correio. Você pode apenas digitar os endereços de email em um arquivo de texto, ou você pode executar um comando no Windows PowerShell para obter uma lista de endereços de email e salvá-los em um arquivo (localizado na mesma pasta que você vai salvar o script na etapa 3).

Aqui está um comando de Windows PowerShell (que você executa usando o PowerShell remoto conectado à sua organização Exchange Online ) para obter uma lista de endereços de email para todos os usuários em sua organização e salvá-lo em um arquivo de texto chamado Users.

Get-Mailbox -ResultSize unlimited -Filter { RecipientTypeDetails -eq 'UserMailbox'} | Select-Object PrimarySmtpAddress > Users.txt

Depois de executar este comando, certifique-se de abrir o arquivo e remover o cabeçalho que contém o nome da propriedade, PrimarySmtpAddress. O arquivo de texto deve conter apenas uma lista de endereços de email e nada mais. Verifique não se que há nenhuma linha em branco antes ou depois da lista de endereços de email.

Retornar ao início

Etapa 3: Executar o script para criar e iniciar a pesquisa

Quando você executa o script nesta etapa, ele solicitará que você as seguintes informações. Certifique-se de que essas informações prontas antes de executar o script.

  • Suas credenciais de usuário  O script usará suas credenciais para acessar SharePoint Online para acessar as URLs de OneDrive for Business e conectem a Centro de Conformidade e Segurança com o PowerShell remoto.

  • Nome do seu domínio de meusite  O domínio de meusite é o domínio que contém todos os sites de OneDrive for Business em sua organização. Por exemplo, se a URL do seu domínio de meusite for https://contoso-my.sharepoint.com, em seguida, você digitaria contoso quando o script solicita o nome do seu domínio de meusite.

  • Caminho do arquivo de texto da etapa 2  O nome do caminho do arquivo de texto que você criou na etapa 2. Se o arquivo de texto e o script estão localizados na mesma pasta, insira o nome do arquivo de texto. Caso contrário, insira o caminho completo para o arquivo de texto.

  • Nome da pesquisa Conteúda   O nome da pesquisa conteúdo que será criado pelo script.

  • Consulta de pesquisa   A consulta de pesquisa que será usada com a pesquisa de conteúdo é criada e executada. Para obter mais informações sobre consultas de pesquisa, consulte consultas de palavra-chave e critérios de pesquisa para pesquisa de conteúdo.

  1. Salvar o texto a seguir em um arquivo de script Windows PowerShell usando o sufixo filename. ps1; Por exemplo, SearchEXOOD4B.ps1. Salve o arquivo na mesma pasta onde você salvou na lista de usuários na etapa 2.

    # This PowerShell script will prompt you for the following information:
    #    * Your user credentials 
    #    * The name of your organization's MySite domain                                              
    #    * The pathname for the text file that contains a list of user email addresses
    #    * The name of the Content Search that will be created
    #    * The search query string
    # The script will then:
    #    * Find the OneDrive for Business site for each user in the text file
    #    * Create and start a Content Search using the above information
    
    
    # Get user credentials
    if (!$credentials)
    {
        $credentials = Get-Credential
    }
    
    # Get the user's MySite domain name.  We use this to create the admin URL and root URL for OneDrive for Business
    $mySiteDomain = Read-Host "What is your organization's MySite domain?  For example,  'contoso' for 'https://contoso-my.sharepoint.com'"
    $AdminUrl = "https://$mySiteDomain-admin.sharepoint.com"
    $mySiteUrlRoot = "https://$mySiteDomain-my.sharepoint.com"
    
    # Get other required information
    $inputfile = read-host "Enter the file name of the text file that contains the email addresses for the users you want to search"
    $searchName = Read-Host "Enter the name for the new search"
    $searchQuery = Read-Host "Enter the search query you want to use"
    $emailAddresses = Get-Content $inputfile | where {$_ -ne ""}  | foreach{ $_.Trim() }
    
    # Connect to Office 365
    if (!$s -or !$a)
    {
        $s = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri "https://ps.compliance.protection.outlook.com/powershell-liveid" -Credential $credentials -Authentication Basic -AllowRedirection -SessionOption (New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck)
        $a = Import-PSSession $s -AllowClobber
    
        if (!$s)
        {
            Write-Error "Could not create PowerShell session."
            return;
        }
    }
    
    # Load the SharePoint assemblies from the SharePoint Online Management Shell
    # To install, go to http://go.microsoft.com/fwlink/p/?LinkId=255251
    if (!$SharePointClient -or !$SPRuntime -or !$SPUserProfile)
    {
        $SharePointClient = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client")
        $SPRuntime = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client.Runtime")
        $SPUserProfile = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client.UserProfiles")
    
        if (!$SharePointClient)
        {
            Write-Error "SharePoint Online Management Shell isn't installed, please install from: http://go.microsoft.com/fwlink/p/?LinkId=255251 and then run this script again"
            return;
        }
    }
    
    if (!$spCreds)
    {
        $spCreds = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($credentials.UserName, $credentials.Password)
    }
    
    # Add the path of the User Profile Service to the SPO admin URL, then create a new webservice proxy to access it
    $proxyaddr = "$AdminUrl/_vti_bin/UserProfileService.asmx?wsdl"
    $UserProfileService= New-WebServiceProxy -Uri $proxyaddr -UseDefaultCredential False
    $UserProfileService.Credentials = $credentials
    
    # Take care of auth cookies
    $strAuthCookie = $spCreds.GetAuthenticationCookie($AdminUrl)
    $uri = New-Object System.Uri($AdminUrl)
    $container = New-Object System.Net.CookieContainer
    $container.SetCookies($uri, $strAuthCookie)
    $UserProfileService.CookieContainer = $container
    
    Write-Host "Getting each user's OneDrive for Business URL"
    $urls = @()
    foreach($emailAddress in $emailAddresses)
    {
        try
        {
            $prop = $UserProfileService.GetUserProfileByName("i:0#.f|membership|$emailAddress") | Where-Object { $_.Name -eq "PersonalSpace" } 
            $url = $prop.values[0].value
            $furl = $mySiteUrlRoot + $url
            $urls += $furl
            Write-Host "-$emailAddress => $furl"
        }
        catch
        {
            Write-Warning "Could not locate OneDrive for $emailAddress"
        }
    }
    
    Write-Host "Creating and starting the search"
    $search = New-ComplianceSearch -Name $searchName -ExchangeLocation $emailAddresses -SharePointLocation $urls -ContentMatchQuery $searchQuery
    
    # Finally, start the search and then display the status
    if($search)
    {
        Start-ComplianceSearch $search.Name
        Get-ComplianceSearch $search.Name
    }
    
  2. Abra Windows PowerShell e vá para a pasta onde você salvou o script e a lista de usuários da etapa 2.

  3. Iniciar o script; Por exemplo:

    .\SearchEXOOD4B.ps1
  4. Quando solicitado para suas credenciais, insira seu endereço de email e senha e clique em OK.

  5. Inserir após informações quando solicitado pelo script. Digite cada informação e pressione Enter.

    • O nome do seu domínio de meu site.

    • O nome do caminho do arquivo de texto que contém a lista de usuários.

    • Um nome para a pesquisa de conteúdo.

    • A consulta de pesquisa (deixe em branco para retornar todos os itens em locais de conteúdo).

    O script obtém as URLs para cada site OneDrive for Business e, em seguida, cria e inicia a pesquisa. Você pode executar o cmdlet Get-ComplianceSearch para exibir as estatísticas de pesquisa e resultados ou você pode ir para a página de pesquisa de conteúdo no Centro de Conformidade e Segurança para exibir informações sobre a pesquisa.

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.

×