Recherche de contenu permet d’effectuer une recherche dans la boîte aux lettres et OneDrive pour le site d’entreprise pour obtenir la liste des utilisateurs

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Le Office 365 Centre de sécurité et conformité fournit un certain nombre de Windows PowerShell des applets de commande qui vous permettent d’automatiser les tâches liés à la découverte électronique beaucoup de temps. Pour l’instant, création d’une recherche de contenu dans le Centre de sécurité et conformité pour rechercher un grand nombre d’emplacements de contenu dépositaire prend temps et préparation. Avant de créer une recherche, vous devez collecter l’URL pour chaque site OneDrive Entreprise, puis ajoutez chaque site boîte aux lettres et OneDrive Entreprise à la recherche. Dans les futures versions, il s’agit plus facile à faire dans la Centre de sécurité et conformité. Jusque là, vous pouvez utiliser le script dans cet article pour automatiser ce processus. Ce script vous invitant au nom de domaine de sites Mon site de votre organisation (par exemple, contoso dans l' URL https://contoso-my.sharepoint.com), une liste d’adresses de messagerie d’utilisateur, le nom de la nouvelle recherche de contenu et la requête de recherche à utiliser. Le script obtient l’URL OneDrive Entreprise pour chaque utilisateur dans la liste, et il crée puis démarre une recherche de contenu qui recherche dans le site de boîte aux lettres et OneDrive Entreprise pour chaque utilisateur dans la liste, à l’aide de la requête de recherche que vous spécifiez.

Voici comment procéder :

Étape 1 : Installer SharePoint Online Management Shell

Étape 2 : Générer une liste des utilisateurs

Étape 3 : Exécuter le script pour créer et démarrer la recherche

Avant de commencer

  • Vous devez être membre du groupe de rôles gestionnaire eDiscovery dans le Centre de sécurité et conformité et un administrateur global SharePoint Online pour exécuter le script à l’étape 3.

  • Veillez à enregistrer la liste des utilisateurs que vous créez dans l’étape 2 et le script à l’étape 3 dans le même dossier. Qui facilitera exécuter le script.

  • Le script comprend la gestion des erreurs minimales. Son objectif principal consiste à rapidement et facilement rechercher sur le site de boîte aux lettres et OneDrive Entreprise de chaque utilisateur.

  • Les exemples de scripts fournis dans cette rubrique ne sont pas pris en charge par les services ou programmes d’assistance standard de Microsoft. Les exemples de scripts sont fournis tels quels, sans garantie d’aucune sorte. Microsoft Corporation décline aussi toute garantie implicite, y compris et sans limitation, les garanties implicites de qualité marchande ou d’adéquation à un usage particulier. La totalité des risques découlant de l’utilisation ou de la performance des exemples de scripts et de la documentation repose sur vous. En aucun cas Microsoft, ses auteurs ou quiconque impliqué dans la création, la production ou la livraison des scripts ne sera responsable de tous dommages quels qu’ils soient (y compris, sans limitation, les dommages pour perte de profits, interruption d’activité, perte d’informations commerciales ou toute autre perte pécuniaire) découlant de l’utilisation ou de l’impossibilité d’utiliser les exemples de scripts ou la documentation, même si Microsoft a été informé de la possibilité de tels dommages.

Étape 1 : Installer SharePoint Online Management Shell

La première étape consiste à installer le SharePoint Online Management Shell. Vous n’êtes pas obligé d’utiliser le shell dans cette procédure, mais vous devez l’installer, car elle contient les conditions préalables requises par le script que vous exécutez à l’étape 3. Ces conditions préalables pour permettre le script communiquer avec SharePoint Online pour obtenir l’URL pour les sites OneDrive Entreprise.

Accédez à configurer l’environnement SharePoint Online Management Shell Windows PowerShell et effectuez l’étape 1 et l’étape 2 pour installer le SharePoint Online Management Shell.

Revenir au début

Étape 2 : Générer une liste des utilisateurs

Le script à l’étape 3 crée une recherche de contenu pour effectuer une recherche dans les boîtes aux lettres et les sites OneDrive Entreprise d’une liste des utilisateurs. Vous pouvez simplement taper les adresses de messagerie dans un fichier texte, ou vous pouvez exécuter une commande dans Windows PowerShell pour obtenir une liste d’adresses de messagerie et les enregistrer dans un fichier (situé dans le même dossier que vous devez enregistrer le script à l’étape 3).

Voici une commande Windows PowerShell (que vous exécutez à l’aide de remote PowerShell connecté à votre organisation Exchange Online ) pour obtenir une liste d’adresses de messagerie pour tous les utilisateurs de votre organisation et enregistrez-le dans un fichier texte nommé Users.txt.

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

Une fois que vous exécutez cette commande, veillez à ouvrir le fichier et supprimer l’en-tête qui contient le nom de la propriété PrimarySmtpAddress. Le fichier texte doit contenir uniquement une liste d’adresses de messagerie et rien d’autre. Vérifiez qu’il n’existe aucune ligne vide avant ou après la liste des adresses de messagerie.

Revenir au début

Étape 3 : Exécuter le script pour créer et démarrer la recherche

Lorsque vous exécutez le script dans cette étape, il vous demandera les informations suivantes. Veillez à préparer les informations suivantes avant d’exécuter le script.

  • Vos informations d’identification utilisateur  Le script va utiliser vos informations d’identification pour accéder à SharePoint Online pour obtenir l’URL OneDrive Entreprise et pour vous connecter à la Centre de sécurité et conformité avec remote PowerShell.

  • Nom de domaine de votre site Mon site  Le domaine de sites Mon site est le domaine qui contient tous les sites OneDrive Entreprise dans votre organisation. Par exemple, si l’URL de votre domaine de sites Mon site est https://contoso-my.sharepoint.com, vous devez entrer contoso lorsque le script vous invitant au nom de domaine de votre site Mon site.

  • Chemin d’accès du fichier texte à l’étape 2  Le chemin d’accès du fichier texte que vous avez créé à l’étape 2. Si le fichier texte et le script sont situés dans le même dossier, puis entrez le nom du fichier texte. Dans le cas contraire, entrez le chemin complet pour le fichier texte.

  • Nom de la recherche de contenu   Le nom de la recherche de contenu qui seront créés par le script.

  • Requête de recherche   La requête de recherche qui est utilisée avec la recherche de contenu est créée et exécuter. Pour plus d’informations sur les requêtes de recherche, voir conditions de recherche pour la recherche de contenu et les requêtes de mot clé.

  1. Enregistrer le texte suivant dans un fichier de script Windows PowerShell à l’aide d’un suffixe filename .ps1 ; par exemple, SearchEXOOD4B.ps1. Enregistrez le fichier dans le même dossier où vous avez enregistré la liste des utilisateurs à l’étape 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. Ouvrez Windows PowerShell et accédez au dossier où vous avez enregistré le script et la liste des utilisateurs à l’étape 2.

  3. Démarrer le script ; par exemple :

    .\SearchEXOOD4B.ps1
  4. Lorsque vous y êtes invité pour vos informations d’identification, entrez votre adresse de messagerie et le mot de passe, puis cliquez sur OK.

  5. Entrez les informations lorsque vous y êtes invité par le script suivantes. Tapez chaque élément d’information et appuyez sur entrée.

    • Le nom de votre domaine de sites Mon site.

    • Le chemin d’accès du fichier texte qui contient la liste des utilisateurs.

    • Un nom pour la recherche de contenu.

    • La requête de recherche (laissez ce vide pour renvoyer tous les éléments dans les emplacements de contenu).

    Le script reçoit les URL pour chaque site OneDrive Entreprise puis crée et démarre la recherche. Vous pouvez soit exécuter l’applet de commande Get-ComplianceSearch pour afficher les statistiques de la recherche et les résultats, ou vous pouvez accéder à la page de recherche de contenu dans le Centre de sécurité et conformité pour afficher des informations sur la recherche.

Revenir au début

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×