Créer, créer des rapports sur et supprimer des recherches de contenu multiples

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

Créer rapidement et de signaler les recherches de découverte sont souvent une étape importante de découverte électronique et les investigations lorsque vous essayez d’en savoir plus sur les données sous-jacentes et la richesse et la qualité de vos recherches. Pour ce faire, le Centre de sécurité et conformité Office 365 propose un ensemble d’applets de commande Windows PowerShell pour automatiser les tâches de recherche de contenu beaucoup de temps. Ils fournissent un moyen rapide et facile pour créer un certain nombre de recherches et exécuter des rapports des résultats de recherche estimées qui peuvent vous aider à déterminer la quantité de données en question. Vous pouvez également utiliser les scripts pour créer des versions différentes de recherches pour comparer les résultats de que chacun d'entre eux génère. Ces scripts peuvent vous aider à rapidement et efficacement identifier et sélectionnons vos données.

Cette rubrique inclut des scripts que vous pouvez exécuter pour créer, Démarrer, créer des rapports sur et supprimer plusieurs recherches. Voici une vue d’ensemble du processus :

Étape 1: Créer un fichier CSV qui contient des informations sur les recherches que vous souhaitez exécuter

Étape 2: Se connecter à la sécurité et le centre de conformité à l’aide de Remote PowerShell

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

Étape 4: Exécuter le script pour signaler la recherche estimations

Étape 5: Exécuter le script pour supprimer les recherches

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 les scripts qui sont décrites dans cette rubrique.

  • Pour regrouper une liste des URL pour les sites OneDrive Entreprise de votre organisation que vous pouvez ajouter le fichier CSV à l’étape 1, utilisez le script dans l’étape 2 de attribuer des autorisations de découverte électronique sur OneDrive pour les sites d’entreprise. Ce script crée un fichier texte qui contient la liste de tous les sites OneDrive Entreprise. Pour exécuter ce script, vous devez installer et utiliser la SharePoint Online Management Shell (voir l’étape 1 dans la rubrique précédente). Vous pouvez utiliser ces URL dans le fichier CSV que vous créez à l’étape 1.

  • Veillez à enregistrer tous les fichiers que vous créez dans cette rubrique dans le même dossier. Qui facilitera exécuter les scripts.

  • Les scripts minime gestion des erreurs. Leur objectif principal consiste à créer rapidement, créer des rapports sur et supprimer plusieurs recherches de contenu.

  • Les exemples de scripts fournies dans cette rubrique ne sont pas pris en charge sous n’importe quel programme de support standard Microsoft ou un service. Les exemples de scripts sont fournis 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 des exemples de scripts et documentation restent avec vous. Aucun cas sont Microsoft, ses auteurs, ou tout autre utilisateur impliqués dans la création, production, ou livraison des scripts être responsabilité pour toute 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.

Étape 1: Créer un fichier CSV qui contient des informations sur les recherches que vous souhaitez exécuter

Le fichier (CSV) de valeurs séparées par une virgule que vous créez dans cette étape contient une ligne pour chaque utilisateur que vous voulez effectuer une recherche. Vous pouvez rechercher des boîtes aux lettres Exchange Online de l’utilisateur (y compris la boîte aux lettres archive, s’il est activé) et leur site OneDrive Entreprise. Ou vous pouvez rechercher simplement la boîte aux lettres ou sur le site OneDrive Entreprise. Vous pouvez également rechercher tous les sites de votre organisation SharePoint Online. Le script que vous exécutez à l’étape 3 crée une recherche distincte pour chaque ligne dans le fichier CSV.

  1. Copiez et collez le texte suivant dans un fichier .txt en utilisant le bloc-notes. Enregistrer ce fichier dans un dossier sur votre ordinateur local. Vous économiserez les autres scripts dans ce dossier également.

    ExchangeLocation,SharePointLocation,ContentMatchQuery,StartDate,EndDate
    sarad@contoso.onmicrosoft.com,https://contoso-my.sharepoint.com/personal/sarad_contoso_onmicrosoft_com,(lawsuit OR legal),1/1/2000,12/31/2005
    sarad@contoso.onmicrosoft.com,https://contoso-my.sharepoint.com/personal/sarad_contoso_onmicrosoft_com,(lawsuit OR legal),1/1/2006,12/31/2010
    sarad@contoso.onmicrosoft.com,https://contoso-my.sharepoint.com/personal/sarad_contoso_onmicrosoft_com,(lawsuit OR legal),1/1/2011,3/21/2016
    ,https://contoso.sharepoint.com/sites/contoso,,,3/21/2016
    ,https://contoso-my.sharepoint.com/personal/davidl_contoso_onmicrosoft_com,,1/1/2015,
    ,https://contoso-my.sharepoint.com/personal/janets_contoso_onmicrosoft_com,,1/1/2015,

    La première ligne ou la ligne d’en-tête, du fichier répertorie les paramètres devant servir à créer un nouveau contenu des recherches par cmdlet New-ComplianceSearch (dans le script à l’étape 3). Nom de chaque paramètre est séparé par une virgule. Vérifiez que ne contient pas d’espace dans la ligne d’en-tête. Chaque ligne sous la ligne d’en-tête représente les valeurs de paramètre pour chaque recherche. N’oubliez pas de remplacer les données des espaces réservés dans le fichier CSV avec vos données réelles.

  2. Ouvrir le fichier .txt dans Microsoft Excel, puis utilisez les informations du tableau ci-dessous pour modifier le fichier avec les informations de chaque recherche.

    Paramètre

    description

    ExchangeLocation

    L’adresse SMTP de boîte aux lettres de l’utilisateur.

    SharePointLocation

    L’URL de site de OneDrive Entreprise de l’utilisateur ou l’URL d’un site de votre organisation. Pour l’URL des sites OneDrive Entreprise, utilisez ce format : https://<your organization>-my.sharepoint.com/personal/<user alias>_<your organization>_onmicrosoft_com. Par exemple, https://contoso-my.sharepoint.com/personal/sarad_contoso_onmicrosoft_com.

    ContentMatchQuery

    La requête de recherche pour la recherche. Pour plus d’informations sur la création d’une requête de recherche, voir conditions de recherche pour la recherche de contenu et les requêtes de mot clé.

    StartDate

    Pour la messagerie, la date ou à partir d’un message a été reçue par un destinataire ou envoyée par l’expéditeur. Pour les documents sur des sites SharePoint ou OneDrive Entreprise, la date ou à partir d’un document a été modifiée en dernier.

    EndDate

    Pour la messagerie, la date ou avant qu’un message a été envoyée par un envoyés par l’utilisateur. Pour les documents sur des sites SharePoint ou OneDrive Entreprise, la date ou avant un document a été modifiée en dernier.

  3. Enregistrez le fichier Excel dans un fichier CSV à un dossier sur votre ordinateur local. Le script que vous créez à l’étape 3 utilisera les informations dans ce fichier CSV pour créer les recherches.

Revenir au début

Étape 2: Se connecter à la sécurité et le centre de conformité à l’aide de Remote PowerShell

L’étape suivante consiste à se connecter Windows PowerShell à Centre de sécurité et conformité pour votre organisation.

  1. Enregistrer le texte suivant dans un fichier de script Windows PowerShell en utilisant un nom de fichier suffixe .ps1 ; par exemple, ConnectSCC.ps1. Enregistrez le fichier dans le même dossier que vous avez enregistré le fichier CSV à l’étape 1.

    # Get login credentials 
    $UserCredential = Get-Credential 
    $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.compliance.protection.outlook.com/powershell-liveid -Credential $UserCredential -Authentication Basic -AllowRedirection 
    Import-PSSession $Session -AllowClobber -DisableNameChecking 
    $Host.UI.RawUI.WindowTitle = $UserCredential.UserName + " (Office 365 Security & Compliance Center)" 
    
  2. Sur votre ordinateur local, ouvrez Windows PowerShell, accédez au dossier où se trouve le script que vous avez créé à l’étape précédente et puis exécuter le script ; par exemple :

    .\ConnectSCC.ps1

Revenir au début

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

Le script dans cette étape crée une recherche de contenu distincte pour chaque ligne dans le fichier CSV que vous avez créé à l’étape 1. Lorsque vous exécutez ce script, vous serez invité pour deux valeurs :

  • ID du groupe de recherche   Ce nom est un moyen simple pour organiser les recherches créés à partir du fichier CSV. Chaque recherche créé est nommé avec l’ID du groupe recherche et puis un numéro est ajouté dans le nom de recherche. Par exemple, si vous entrez ContosoCase pour l’ID de groupe de recherche, les recherches sont nommés ContosoCase_1, ContosoCase_2, ContosoCase_3et ainsi de suite. Notez que le nom que vous tapez respecte la casse. Lorsque vous utilisez l’ID du groupe de recherche dans l’étape 4 et 5 de l’étape, vous devez utiliser la même casse que vous avez effectuées lors de sa création.

  • Fichier CSV   Le nom du fichier CSV que vous avez créé à l’étape 1. N’oubliez pas d’inclure l’utilisation du nom de fichier complet, l’extension de fichier .csv ; par exemple, ContosoCase.csv.

  1. Enregistrer le texte suivant dans un fichier de script Windows PowerShell à l’aide d’un nom de fichier suffixe .ps1 ; par exemple, CreateSearches.ps1. Enregistrez le fichier dans le même dossier où vous avez enregistré les autres fichiers.

    # Get the Search Group ID and the location of the CSV input file
    $searchGroup = Read-Host 'Search Group ID'
    $csvFile = Read-Host 'Source CSV file'
    	
    # Do a quick check to make sure our group name will not collide with other searches
    $searchCounter = 1
    import-csv $csvFile |
    	ForEach-Object{
    	
    	$searchName = $searchGroup +'_' + $searchCounter
    	$search = Get-ComplianceSearch $searchName -EA SilentlyContinue
    	if ($search)
    	{
    	    Write-Error "The Search Group ID conflicts with existing searches.  Please choose a search group name and restart the script."
    	    return
    	}
    	$searchCounter++
    }
    	
    $searchCounter = 1
    import-csv $csvFile |
    	ForEach-Object{
    	
    	# Create the query
    	$query = $_.ContentMatchQuery
    	if(($_.StartDate -or $_.EndDate))
    	{
            # Add the appropriate date restrictions.  NOTE: Using the Date condition property here because it works across Exchange, SharePoint, and OneDrive for Business.
            # For Exchange, the Date condition property maps to the Sent and Received dates; for SharePoint and OneDrive for Business, it maps to Created and Modified dates.
    
            if($query)
            {
                $query += " AND"
            }
    
            $query += " ("
    
            if($_.StartDate)
            {
                $query += "Date >= " + $_.StartDate
            }
    
            if($_.EndDate)
            {
                if($_.StartDate)
                {
                    $query += " AND "
                }
                $query += "Date <= " + $_.EndDate
            }
    
            $query += ")"
    	}
        
        # -ExchangeLocation can't be set to an empty string, set to null if there's no location.
        $exchangeLocation = $null
        if ( $_.ExchangeLocation)
        {
             $exchangeLocation = $_.ExchangeLocation
        }
    	
    	# Create and run the search        
    	$searchName = $searchGroup +'_' + $searchCounter
    	Write-Host "Creating and running search: " $searchName -NoNewline
    	$search = New-ComplianceSearch -Name $searchName -ExchangeLocation $exchangeLocation -SharePointLocation $_.SharePointLocation -ContentMatchQuery $query
    	
    	# Start and wait for each search to complete
    	Start-ComplianceSearch $search.Name
    	while ((Get-ComplianceSearch $search.Name).Status -ne "Completed")
    	{
    	    Write-Host " ." -NoNewline
    	    Start-Sleep -s 3
    	}
    	Write-Host ""
    	
    	$searchCounter++
    }
  2. Dans Windows PowerShell, accédez au dossier où vous avez enregistré le script dans l’étape précédente, puis exécutez le script ; par exemple :

    .\CreateSearches.ps1
  3. À l’invite de Recherche ID du groupe, tapez un nom de groupe de recherche et appuyez sur entrée; par exemple, ContosoCase. N’oubliez pas que ce nom respecte la casse, vous en aurez taper la même façon dans les étapes suivantes.

  4. À l’invite de fichier CSV Source, tapez le nom du fichier CSV, y compris l’extension de fichier .csv ; par exemple, ContosoCase.csv.

  5. Appuyez sur entrée pour continuer à exécuter le script.

    Le script affiche la progression de la création et la recherche en cours d’exécution. Une fois le script terminé, elle renvoie à l’invite.

    Exemple de sortie d’exécuter le script pour créer plusieurs recherches de conformité

Revenir au début

Étape 4: Exécuter le script pour signaler la recherche estimations

Après avoir créé les recherches, l’étape suivante consiste à exécuter un script qui affiche un état simple au nombre de résultats de la recherche pour chaque recherche qui a été créé à l’étape 3. Le rapport inclut également la taille des résultats pour chaque recherche et le nombre total d’accès et la taille totale de toutes les recherches. Lorsque vous exécutez le script de création de rapports, vous serez invité pour l’ID de groupe de recherche et un nom de fichier CSV si vous voulez enregistrer le rapport dans un fichier CSV.

  1. Enregistrer le texte suivant dans un fichier de script Windows PowerShell à l’aide d’un nom de fichier suffixe .ps1 ; par exemple, SearchReport.ps1. Enregistrez le fichier dans le même dossier où vous avez enregistré les autres fichiers.

    $searchGroup = Read-Host 'Search Group ID'
    $outputFile = Read-Host 'Enter a file name or file path to save the report to a .csv file. Leave blank to only display the report'
    
    $searches = Get-ComplianceSearch | ?{$_.Name -clike $searchGroup + "_*"}
    
    $allSearchStats = @()
    foreach ($partialObj in $searches)
    {
        $search = Get-ComplianceSearch $partialObj.Name
    
        $sizeMB = [System.Math]::Round($search.Size / 1MB, 2)
    
        $searchStatus = $search.Status
        if($search.Errors)
        {
            $searchStatus = "Failed"
        }elseif($search.NumFailedSources -gt 0)
        {
            $searchStatus = "Failed Sources"
        }
    
        $searchStats = New-Object PSObject
        Add-Member -InputObject $searchStats -MemberType NoteProperty -Name Name -Value $search.Name
        Add-Member -InputObject $searchStats -MemberType NoteProperty -Name ContentMatchQuery -Value $search.ContentMatchQuery
        Add-Member -InputObject $searchStats -MemberType NoteProperty -Name Status -Value $searchStatus
        Add-Member -InputObject $searchStats -MemberType NoteProperty -Name Items -Value $search.Items
        Add-Member -InputObject $searchStats -MemberType NoteProperty -Name "Size" -Value $search.Size
        Add-Member -InputObject $searchStats -MemberType NoteProperty -Name "Size(MB)" -Value $sizeMB
    
        $allSearchStats += $searchStats
    }
    
    # Calculate the totals
    $allItems = ($allSearchStats | Measure-Object Items -Sum).Sum
    
    # Convert the total size to MB and round to the nearst 100th
    $allSize = ($allSearchStats | Measure-Object 'Size' -Sum).Sum
    $allSizeMB = [System.Math]::Round($allSize  / 1MB, 2)
    
    # Get the total successful searches and total of all searches
    $allSuccessCount = ($allSearchStats |?{$_.Status -eq "Completed"}).Count
    $allCount = $allSearchStats.Count
    $allStatus = [string]$allSuccessCount + " of " + [string]$allCount
    
    # Totals Row
    $totalSearchStats = New-Object PSObject
    Add-Member -InputObject $totalSearchStats -MemberType NoteProperty -Name Name -Value "Total"
    Add-Member -InputObject $totalSearchStats -MemberType NoteProperty -Name Status -Value $allStatus
    Add-Member -InputObject $totalSearchStats -MemberType NoteProperty -Name Items -Value $allItems
    Add-Member -InputObject $totalSearchStats -MemberType NoteProperty -Name "Size(MB)" -Value $allSizeMB
    $allSearchStats += $totalSearchStats
    
    # Just get the columns we're interested in showing
    $allSearchStatsPrime = $allSearchStats | Select-Object Name, Status, Items, "Size(MB)", ContentMatchQuery
    
    # Print the results to the screen
    $allSearchStatsPrime |ft -AutoSize -Wrap
    
    # Save the results to a CSV file
    if ($outputFile)
    {
        $allSearchStatsPrime | Export-Csv -Path $outputFile -NoTypeInformation
    }
  2. Dans Windows PowerShell, accédez au dossier où vous avez enregistré le script dans l’étape précédente, puis exécutez le script ; par exemple :

    .\SearchReport.ps1
  3. À l’invite de Recherche ID du groupe, tapez un nom de groupe de recherche et appuyez sur entrée; par exemple, ContosoCase. N’oubliez pas que ce nom respecte la casse, vous en aurez taper la même façon que lorsque vous avez exécuté le script à l’étape 3.

  4. À l’invite de fichier chemin d’accès pour enregistrer le rapport dans un fichier CSV (laisser vide pour simplement afficher le rapport), tapez un nom de fichier du chemin d’accès de nom de fichier complet (y compris l’extension de fichier .csv) si vous voulez enregistrer le rapport dans un fichier CSV. nom du fichier CSV, y compris l’extension de fichier .csv. Par exemple, vous pouvez taper ContosoCaseReport.csv pour l’enregistrer dans le répertoire actif ou vous pouvez taper C:\Users\admin\OneDrive for Business\ContosoCase\ContosoCaseReport.csv pour l’enregistrer dans un autre dossier. Vous pouvez également laisser l’invite vide pour afficher le rapport, mais pas l’enregistrer dans un fichier.

  5. Appuyez sur entrée.

    Le script affiche la progression de la création et la recherche en cours d’exécution. Une fois le script terminé, le rapport s’affiche.

    Exécuter le rapport de recherche pour afficher les estimations pour le groupe de recherche

Revenir au début

Remarque : Si la boîte aux lettres ou le site n’est spécifié comme emplacement de contenu dans plusieurs recherche dans un groupe de recherche, l’estimation total des résultats dans le rapport (pour le nombre d’éléments et la taille totale) peut-être inclure des résultats pour les mêmes éléments. C’est parce que le même message électronique ou le document à compter plusieurs fois s’il correspond à la requête pour les recherches différentes dans le groupe de recherche.

Étape 5: Exécuter le script pour supprimer les recherches

Étant donné que vous pouvez créer un grand nombre de recherches, ce dernier script simplement facilite supprimer rapidement les recherches que vous avez créé à l’étape 3. Comme les autres scripts, celui-ci également vous invitant à l’ID de groupe de recherche. Toutes les recherches de l’ID du groupe de recherche dans le nom de recherche sont supprimés lorsque vous exécutez ce script.

  1. Enregistrer le texte suivant dans un fichier de script Windows PowerShell à l’aide d’un nom de fichier suffixe .ps1 ; par exemple, DeleteSearches.ps1. Enregistrez le fichier dans le même dossier où vous avez enregistré les autres fichiers.

    # Delete all searches in a search group
    $searchGroup = Read-Host 'Search Group ID'
    Get-ComplianceSearch |
        ForEach-Object{
    
        # If the name matches the search group name pattern (case sensitive), delete the search
        if ($_.Name -cmatch $searchGroup + "_\d+")
        {
            Write-Host "Deleting search: " $_.Name
            Remove-ComplianceSearch $_.Name -Confirm:$false
        }
    }
  2. Dans Windows PowerShell, accédez au dossier où vous avez enregistré le script dans l’étape précédente, puis exécutez le script ; par exemple :

    .\DeleteSearches.ps1
  3. À l’invite de Recherche ID du groupe, tapez un nom de groupe de recherche pour les recherches que vous voulez supprimer et appuyez sur entrée; par exemple, ContosoCase. N’oubliez pas que ce nom respecte la casse, vous en aurez taper la même façon que lorsque vous avez exécuté le script à l’étape 3.

    Le script affiche le nom de chaque recherche est supprimé.

    Exécuter le script pour supprimer les recherches dans le groupe de 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.

×