Partager via

Cloner une recherche de contenu

  • Article

Conseil

eDiscovery (préversion) est désormais disponible dans le nouveau portail Microsoft Purview. Pour en savoir plus sur l’utilisation de la nouvelle expérience eDiscovery, consultez En savoir plus sur eDiscovery (préversion).

La création d’une recherche de contenu dans le portail de conformité Microsoft Purview dans Microsoft 365 qui recherche de nombreuses boîtes aux lettres ou des sites SharePoint et OneDrive Entreprise peut prendre un certain temps. La spécification des sites à rechercher peut également être sujette à des erreurs si vous entrez mal une URL. Pour éviter ces problèmes, vous pouvez utiliser le script Windows PowerShell de cet article pour cloner rapidement une recherche de contenu existante. Lorsque vous clonez une recherche, une nouvelle recherche (avec un nom différent) est créée et contient les mêmes propriétés (telles que les emplacements de contenu et la requête de recherche) que la recherche d’origine. Vous pouvez ensuite modifier la nouvelle recherche en modifiant la requête de mot clé ou la plage de dates, puis l’exécuter.

Pourquoi cloner des recherches de contenu ?

  • Pour comparer les résultats de différentes requêtes de recherche par mot clé, exécutez sur les mêmes emplacements de contenu.

  • Pour éviter d’avoir à revenir à un grand nombre d’emplacements de contenu lorsque vous créez une recherche.

  • Pour réduire la taille des résultats de la recherche. Par exemple, si vous avez une recherche qui retourne trop de résultats à exporter, vous pouvez cloner la recherche, puis ajouter une condition de recherche basée sur une plage de dates pour réduire le nombre de résultats de recherche.

Conseil

Si vous n’êtes pas un client E5, utilisez la version d’évaluation de 90 jours des solutions Microsoft Purview pour découvrir comment les fonctionnalités supplémentaires de Purview peuvent aider votre organisation à gérer les besoins en matière de sécurité et de conformité des données. Commencez maintenant sur le hub d’essais du portail de conformité Microsoft Purview. En savoir plus sur les conditions d’inscription et d’essai.

Informations de script

  • Vous devez installer le module Exchange Online PowerShell. Pour obtenir des instructions, consultez Installer et gérer le module Exchange Online PowerShell.

  • Vous devez être membre du groupe de rôles Gestionnaire eDiscovery dans le portail de conformité Microsoft Purview pour exécuter le script décrit dans cette rubrique.

  • Le script inclut une gestion minimale des erreurs. L’objectif principal du script est de cloner rapidement une recherche de contenu.

  • Le script crée une recherche de contenu, mais ne la démarre pas.

  • Ce script prend en compte si la recherche de contenu que vous clonez est associée à un cas eDiscovery. Si la recherche est associée à un cas, la nouvelle recherche est également associée au même cas. Si la recherche existante n’est pas associée à un cas, la nouvelle recherche est répertoriée dans la page Recherche de contenu dans le portail de conformité Microsoft Purview.

  • L’exemple de script fourni dans cette rubrique n’est pris en charge par aucun programme ou service de support standard Microsoft. L’exemple de script est fourni tel quel, 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 de l’exemple de script 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.

Le script de cette étape crée une recherche de contenu en clonant une recherche existante. Lorsque vous exécutez ce script, vous êtes invité à fournir les informations suivantes :

  • Vos informations d’identification utilisateur : le script utilise vos informations d’identification pour se connecter à PowerShell sécurité & conformité. Comme indiqué précédemment, vous devez être membre du groupe de rôles Gestionnaire eDiscovery dans le portail de conformité Microsoft Purview pour exécuter le script.

  • Nom de la recherche existante : il s’agit de la recherche de contenu que vous souhaitez cloner.

  • Nom de la nouvelle recherche qui sera créée : si vous laissez cette valeur vide, le script crée un nom pour la nouvelle recherche basé sur le nom de la recherche que vous clonez.

Pour cloner une recherche :

  1. Enregistrez le texte suivant dans un fichier de script Windows PowerShell en utilisant le suffixe de nom de fichier .ps1 ; par exemple, CloneSearch.ps1.

    # This PowerShell script clones an existing content search in Microsoft Purview compliance.

# Ask for the name of the search you want to clone
$searchName = Read-Host 'Enter the name of the search that you want to clone'
# Ask for the name of the new search
$newSearchName = Read-Host 'Enter a name for the new search [leave blank to automatically generate a name]'
$originalSearch = Get-ComplianceSearch $searchName -EA SilentlyContinue
# Make sure we have a valid search before continuing
if(!$originalSearch)
{
    Write-Error "Couldn't find search: $searchName"
    return
}
$searchNameCounter = 1
# Find a suitable name for the new search
while(!$newSearchName)
{
    $newSearchName = $originalSearch.Name + "_" + $searchNameCounter
    $tempSearch = Get-ComplianceSearch $newSearchName -EA SilentlyContinue
    if ($tempSearch)
    {
        $newSearchName = $null
        $searchNameCounter++
    }
}
$caseName
# Determine if the search is part of a case; if so get the case name
if ($originalSearch.CaseId)
{
    $searchCase = Get-ComplianceCase $originalSearch.CaseId
    $caseName = $searchCase.Name
}
# Need to cast this value as a Boolean the old fashion way
$allowNotFoundExchangeLocationsEnabled = $false
if ($originalSearch.AllowNotFoundExchangeLocationsEnabled)
{
    $allowNotFoundExchangeLocationsEnabled = $true
}
$newSearch = New-ComplianceSearch -Name $newSearchName -AllowNotFoundExchangeLocationsEnabled $allowNotFoundExchangeLocationsEnabled -Case $caseName -ContentMatchQuery $originalSearch.ContentMatchQuery -Description $originalSearch.Description -ExchangeLocation $originalSearch.ExchangeLocation -ExchangeLocationExclusion $originalSearch.ExchangeLocationExclusion -Language $originalSearch.Language -SharePointLocation $originalSearch.SharePointLocation -SharePointLocationExclusion $originalSearch.SharePointLocationExclusion -PublicFolderLocation $originalSearch.PublicFolderLocation
if ($newSearch)
{
    Write-Host $newSearch.Name "was successfully created" -ForegroundColor Yellow
}

  2. Se connecter à Security & Compliance PowerShell. Dans la même fenêtre PowerShell, accédez au dossier dans lequel vous avez enregistré le script.

  3. Exécutez le script ; par exemple:

    .\CloneSearch.ps1

  4. Entrez les informations suivantes lorsque vous y êtes invité par le script. Tapez chaque information, puis appuyez sur Entrée.

    • Nom de la recherche existante.
    • Nom de la nouvelle recherche.

    Le script crée la recherche de contenu, mais ne la démarre pas. Cela vous donne la possibilité de modifier et d’exécuter la recherche à l’étape suivante. Vous pouvez afficher les propriétés de la nouvelle recherche en exécutant l’applet de commande Get-ComplianceSearch ou en accédant à la page Recherche de contenu ou eDiscovery dans le portail de conformité Microsoft Purview, selon que la nouvelle recherche est associée ou non à un cas.

Étape 2 : Modifier et exécuter la recherche cloné dans le portail de conformité Microsoft Purview

Après avoir exécuté le script pour cloner une recherche de contenu existante, l’étape suivante consiste à accéder au portail de conformité Microsoft Purview pour modifier et exécuter la nouvelle recherche. Comme indiqué précédemment, vous pouvez modifier une recherche en modifiant la requête de recherche par mot clé et en ajoutant ou supprimant des conditions de recherche. Pour plus d’informations, reportez-vous aux rubriques suivantes :