Utiliser la recherche de contenu dans Office 365 pour les collections de sites

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

La fonctionnalité de recherche de contenu dans le Centre de sécurité et conformité Office 365 ne permet pas directement dans l’interface utilisateur pour rechercher des dossiers spécifiques dans les boîtes aux lettres Exchange ou sites SharePoint et OneDrive Entreprise. Toutefois, il est possible de rechercher des dossiers spécifiques (appelés un destinée aux collection) en spécifiant l’ID de dossier ou le chemin d’accès dans la syntaxe de requête de recherche réel. À l’aide de la recherche de contenu pour effectuer un regroupement ciblé est utile lorsque vous êtes sûr que les éléments injoignable à un cas ou éléments dotés de privilèges sont situés dans un dossier de boîte aux lettres ou un site spécifique. Vous pouvez utiliser le script dans cet article pour obtenir l’ID de dossier pour les dossiers de boîte aux lettres ou le chemin d’accès pour les dossiers sur un site SharePoint et OneDrive Entreprise. Puis vous pouvez utiliser l’ID de dossier ou le chemin d’accès dans une requête de recherche pour renvoyer les éléments situé dans le dossier.

Voici comment procéder :

Étape 1 : Exécuter le script pour obtenir une liste des dossiers pour un site ou une boîte aux lettres

Étape 2 : Utiliser un ID de dossier ou le chemin d’accès pour effectuer un regroupement ciblé

Plus d’informations

Avant de commencer

  • Vous devez être membre du groupe de rôle de gestionnaire eDiscovery dans le Centre de sécurité et conformité pour exécuter le script à l’étape 1. Pour plus d’informations, voir Attribution d’autorisations de découverte électronique dans le centre de conformité Office 365 sécurité.

    En outre, vous devez attribuer le rôle de destinataires des messages de votre organisation Exchange Online. Cela est nécessaire pour exécuter l’applet de commande Get-MailboxFolderStatistics , qui est incluse dans le script à l’étape 1. Par défaut, le rôle de destinataires est attribué pour les groupes de rôles gestion de l’organisation et gestion des destinataires dans Exchange Online. Pour plus d’informations sur l’attribution d’autorisations dans Exchange Online, voir Gérer les membres de groupe de rôles. Vous pourriez également créer un groupe de rôles personnalisé, lui affecter le rôle de destinataires, puis ajoutez les membres ayant besoin d’exécuter le script à l’étape 1. Pour plus d’informations, voir Gérer les groupes de rôle.

  • Chaque fois que vous exécutez le script à l’étape 1, une nouvelle session PowerShell distante est créée. Ainsi, vous pouvez utiliser la toutes les sessions à distance PowerShell disponibles. Pour éviter cela, vous pouvez exécuter la commande suivante pour déconnecter votre session PowerShell distante active.

    Get-PSSession | Remove-PSSession

    Pour plus d’informations, voir se connecter à Exchange Online PowerShell.

  • Le script comprend la gestion des erreurs minimales. L’objectif principal du script consiste à rapidement afficher la liste des ID de dossier boîte aux lettres ou chemins d’accès qui peuvent être utilisés dans la syntaxe de requête de recherche d’une recherche de contenu pour effectuer un regroupement ciblé du site.

  • L’exemple de script fournie dans cette rubrique n’est pas pris en charge sous n’importe quel programme de support standard Microsoft ou un service. L’exemple de script est fourni en l’état sans aucune garantie. Microsoft exclut toutes garanties implicites comprenant, sans limitation, les garanties de qualité ou d’adéquation à un usage particulier implicites. Tous les risques liés à l’utilisation ou les performances de l’exemple de script et à la documentation restent avec vous. Dans aucun événement doit Microsoft, ses auteurs, ou de tout autre utilisateur impliqués dans la création, production, ou de remise des scripts ne pourra de dommages quelque (y compris, sans limitation, les pertes de bénéfices, interruption d’activité, perte d’informations commerciales ou toute autre perte FINANCIERE) liés à l’utilisation d’ou impossibilité d’utiliser les exemples de scripts ou la documentation, même si Microsoft a été averti de l’éventualité de tels dommages.

Revenir au début

Étape 1 : Exécuter le script pour obtenir une liste des dossiers pour un site ou une boîte aux lettres

Le script que vous exécutez cette première étape renverra une liste de dossiers de boîte aux lettres ou dossiers SharePoint ou OneDrive Entreprise et l’ID de dossier correspondant ou le chemin d’accès pour chaque dossier. Lorsque vous exécutez ce script, il vous demandera les informations suivantes.

  • URL de site ou adresse de messagerie    Tapez une adresse de messagerie de la dépositaire renvoie une liste de Exchange dossiers de boîte aux lettres et de pliure ID. Ou tapez l’URL d’un site SharePoint ou d’un site OneDrive Entreprise pour renvoyer une liste des chemins d’accès pour le site spécifié. Voici quelques exemples :

    • Exchange   stacig@contoso.onmicrosoft.com

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

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

  • Vos informations d’identification utilisateur    Le script va utiliser vos informations d’identification pour vous connecter à Exchange Online et Centre de sécurité et conformité avec remote PowerShell. Comme expliqué précédemment, vous avez attribué les autorisations appropriées pour exécuter ce script.

Pour afficher une liste des dossiers de boîte aux lettres ou chemins d’accès du site :

  1. Enregistrer le texte suivant dans un fichier de script Windows PowerShell à l’aide d’un nom de fichier suffixe .ps1 ; par exemple, 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. Sur votre ordinateur local, ouvrez Windows PowerShell et accédez au dossier où vous avez enregistré le script.

  3. Exécuter le script ; par exemple :

    .\GetFolderSearchParameters.ps1
  4. Entrez les informations que le script vous invite à entrer.

    Le script affiche une liste des dossiers de boîte aux lettres ou un dossier de site pour l’utilisateur spécifié. Laisser cette fenêtre Ouvrir afin que vous pouvez copier un nom de dossier ID ou le chemin d’accès et collez-le dans à une requête de recherche à l’étape 2.

    Conseil : Au lieu d’afficher une liste des dossiers dans l’écran d’ordinateur, vous pouvez ré-diriger le résultat du script à un fichier texte. Ce fichier est enregistré dans le dossier où se trouve le script. Par exemple, pour rediriger le script de sortie à un fichier texte, exécutez la commande suivante à l’étape 3 : .\GetFolderSearchParameters.ps1 > StacigFolderIds.txt puis vous pouvez copier un ID de dossier ou le chemin d’accès à partir du fichier à utiliser dans une requête de recherche.

Revenir au début

Sortie du script pour les dossiers de boîte aux lettres

Si vous recevez ID de dossier boîte aux lettres, le script se connecte à Exchange Online à l’aide de remote PowerShell, exécute l’applet de commande Get-MailboxFolderStatisics et puis affiche la liste des dossiers à partir de la boîte aux lettres spécifiée. Pour chaque dossier dans la boîte aux lettres, le script affiche le nom du dossier dans la colonne FolderPath et l’ID de dossier dans la colonne FolderQuery . En outre, le script ajoute le préfixe folderId (qui est le nom de la propriété de boîte aux lettres) à l’ID de dossier. La propriété folderid étant une propriété possibilité de recherche, vous allez utiliser folderid:<folderid> dans une requête de recherche à l’étape 2 pour effectuer une recherche dans ce dossier.

Voici un exemple du résultat retourné par le script pour les dossiers de boîte aux lettres.

Exemple de la liste des dossiers de boîte aux lettres et ID renvoyée par le script de dossier

L’exemple à l’étape 2 affiche la requête utilisée pour rechercher le sous-dossier vide dans le dossier éléments récupérables de l’utilisateur.

Sortie du script pour les dossiers de site

Si vous recevez chemins d’accès à partir des sites SharePoint ou OneDrive Entreprise, le script se connecte à la Centre de sécurité et conformité à l’aide de remote PowerShell, crée une nouvelle recherche de contenu qui recherche dans le site pour les dossiers, puis affiche une liste des dossiers situés dans le site spécifié. Le script affiche le nom de chaque dossier et ajoute le préfixe du chemin d’accès (qui est le nom de la propriété du site) à l’URL du dossier. Étant donné que la propriété chemin d’accès est une propriété possibilité de recherche, vous allez utiliser path:<path> dans une requête de recherche à l’étape 2 pour effectuer une recherche dans ce dossier.

Voici un exemple du résultat retourné par le script pour les dossiers de site.

Exemple de la liste des noms de chemin d’accès pour les dossiers de site renvoyées par le script

Revenir au début

Étape 2 : Utiliser un ID de dossier ou le chemin d’accès pour effectuer un regroupement ciblé

Une fois que vous avez exécuté le script pour collecter la liste des ID de dossier ou chemins d’accès pour un utilisateur spécifique, l’étape suivante pour accéder à la Centre de sécurité et conformité et créer une nouvelle recherche de contenu pour effectuer une recherche dans un dossier spécifique. Vous allez utiliser la propriété folderid:<folderid> ou path:<path> dans la requête de recherche que vous configurez dans la zone de mot clé de recherche de contenu (ou en tant que la valeur du paramètre ContentMatchQuery si vous utilisez l’applet de commande New-ComplianceSearch ). Vous pouvez combiner la propriété folderid ou path avec d’autres paramètres de recherche ou les critères de recherche. Si vous incluez uniquement la propriété folderid ou path dans la requête, la recherche renvoie tous les éléments situés dans le dossier spécifié.

  1. Accédez à la page https://protection.office.com.

  2. Se connecter à Office 365 utilisant le compte et les informations d’identification que vous avez utilisé pour exécuter le script à l’étape 1.

  3. Dans le volet gauche de la Centre de sécurité et conformité, cliquez sur recherche et enquête > recherche de contenu, puis cliquez sur Nouveau Icône Ajouter .

  4. Sur la page Nouvelle recherche, entrez un nom pour la recherche de contenu. Ce nom doit être unique dans votre organisation.

  5. Sous où voulez-vous que nous pour rechercher, effectuez l’une des opérations suivantes, selon que votre recherche dans un dossier de boîte aux lettres ou un dossier de site :

    • Cliquez sur Choisir les boîtes aux lettres spécifiques à rechercher, puis ajoutez la même boîte aux lettres que vous avez spécifiée lorsque vous avez exécuté le script à l’étape 1.

      Ou

    • Cliquez sur Choisir des sites spécifiques à rechercher pour rechercher, puis ajoutez la même URL de site que vous avez spécifiée lorsque vous avez exécuté le script à l’étape 1.

  6. Cliquez sur Suivant

  7. Dans la zone mot clé dans la que voulez-vous que nous pour rechercher de la page, le bouton Coller une valeur folderid:<folderid> ou path:<path> qui a été retourné par le script à l’étape 1.

    Par exemple, la requête dans la capture d’écran suivante recherche n’importe quel élément dans le sous-dossier vide dans le dossier éléments récupérables de l’utilisateur à partir de la capture d’écran de dossiers de boîte aux lettres indiqué à l’étape 1.

    Collez le folderid ou le chemin d’accès à la zone de mot clé de la requête de recherche
  8. Cliquez sur Rechercher pour lancer la recherche de regroupement ciblé.

Revenir au début

Exemples de requêtes de recherche pour les collections de sites

Voici quelques exemples d’utilisation les propriétés folderid et path dans une requête pour effectuer un regroupement ciblé. Notez que les espaces réservés sont utilisés pour folderid:<folderid> et path:<path> à économiser de l’espace.

  • Cet exemple recherche trois dossiers différentes boîtes aux lettres. Vous pouvez utiliser une syntaxe de requête similaire pour effectuer une recherche dans les dossiers masqués dans le dossier éléments récupérables d’un utilisateur.

    folderid:<folderid> OR folderid:<folderid> OR folderid:<folderid>
  • Cet exemple recherche dans un dossier de boîte aux lettres des éléments qui contiennent une expression exacte.

    folderid:<folderid> AND "Contoso financial results"
  • Cet exemple recherche dans un dossier de site (et tous les sous-dossiers) pour les documents qui contiennent les lettres « Accord de confidentialité » dans le titre.

    path:<path> AND filename:nda
  • Cet exemple recherche dans un dossier de site (et tous les sous-dossiers) pour les documents ont été modifiées dans une plage de dates.

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

Revenir au début

Informations complémentaires

Garder les éléments suivants à l’esprit lorsque vous utilisez le script dans cet article et effectuer destinée aux collections de sites.

  • Le script ne supprime pas tous les dossiers à partir des résultats. Pour que certains dossiers répertoriés dans les résultats est peut-être unsearchable (ou renvoyer zéro éléments), car elles contiennent du contenu généré par le système.

  • Ce script renvoie uniquement les informations de dossier pour la boîte aux lettres principale de l’utilisateur. Elle ne renvoie pas d’informations sur les dossiers de boîte aux lettres de l’utilisateur archive.

  • Lorsque vous recherchez des dossiers de boîte aux lettres, seuls le dossier spécifié (identifié par sa propriété folderid ) sera recherché. Sous-dossiers ne sont pas être recherchés. Pour rechercher des sous-dossiers, vous devez utiliser la folderid pour le dossier que vous souhaitez rechercher.

  • Lorsque vous recherchez des dossiers du site, le dossier (identifiée par sa propriété path ) et tous les sous-dossiers être recherchés.

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.

×