Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

New-ComplianceSearch

 

S’applique à :Exchange Server 2016, Office 365 Security & Compliance Center

Dernière rubrique modifiée :2017-05-26

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet New-ComplianceSearch permet de créer des recherches de conformité dans Exchange Server 2016 et dans le Centre de conformité et sécurité dans Office 365. Cette cmdlet vous permet de définir des critères de recherche.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

New-ComplianceSearch -Name <String> [-AllowNotFoundExchangeLocationsEnabled <$true | $false>] [-Case <String>] [-Confirm [<SwitchParameter>]] [-ContentMatchQuery <String>] [-Description <String>] [-ExchangeLocation <String[]>] [-ExchangeLocationExclusion <String[]>] [-Force <SwitchParameter>] [-HoldNames <String[]>] [-Language <CultureInfo>] [-LogLevel <Suppressed | Basic | Full>] [-OneDriveLocation <String[]>] [-OneDriveLocationExclusion <String[]>] [-PublicFolderLocation <String[]>] [-PublicFolderLocationExclusion <String[]>] [-RefinerNames <String[]>] [-SearchNames <String[]>] [-SharePointLocation <String[]>] [-SharePointLocationExclusion <String[]>] [-StatusMailRecipients <String[]>] [-WhatIf [<SwitchParameter>]]

Cet exemple crée une recherche de conformité nommée Hold-Project X qui effectue une recherche pour tous les membres du groupe de distribution nommé Finance Department. Le paramètre ContentMatchQuery n’étant pas défini, la recherche est effectuée dans tous les éléments des boîtes aux lettres.

New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"

Cet exemple crée une recherche de conformité nommée Hold-Tailspin Toys qui effectue une recherche pour tous les membres du groupe de distribution nommé Research Department. Étant donné que la recherche utilise le paramètre ContentMatchQuery, seuls les messages qui correspondent à la requête sont recherchés.

New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"

Cet exemple crée une recherche de conformité nommée « AnnBeebe-InactiveMailbox » qui permet de rechercher une boîte aux lettres inactive et qui renvoie tous les éléments de cette dernière. Pour rechercher des boîtes aux lettres inactives, vous devez utiliser l'adresse SMTP principale de la boîte aux lettres inactive, comportant un point (« . ») en tant que préfixe. Vous devez également inclure le paramètre AllowNotFoundExchangeLocationsEnabled afin que la recherche n'essaie pas de valider l'existence de la boîte aux lettres inactive.

New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true

Une recherche de conformité nécessite au moins un emplacement. Par exemple, des boîtes aux lettres, définies à l’aide du paramètre ExchangeLocation, ou des sites SharePoint, définis à l’aide du paramètre SharePointLocation.

Après avoir créé une recherche de conformité à l’aide de la cmdlet New-ComplianceSearch, exécutez la recherche à l’aide la cmdlet Start-ComplianceSearch.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

Cette cmdlet est disponible dans le rôle Recherche de boîte aux lettres. Par défaut, ce rôle est affecté uniquement au groupe de rôles Gestion de la découverte, et non au groupe de rôles Gestion de l’organisation.

Des autorisations doivent vous avoir été attribuées dans le Centre de conformité et sécurité dans Office 365 pour que vous puissiez utiliser cette cmdlet. Pour plus d’informations, consultez la rubrique Autorisations dans le Centre de sécurité et conformité Office 365.

 

Paramètre Requis Type Description

name

Obligatoire

System.String

Le paramètre Name spécifie le nom de la recherche de conformité. Si la valeur contient des espaces, mettez le nom entre guillemets.

AllowNotFoundExchangeLocationsEnabled

Facultatif

System.Boolean

Le paramètre AllowNotFoundExchangeLocationsEnabled indique si les boîtes aux lettres inactives doivent être prises en compte dans la recherche de conformité. Une boîte aux lettres inactive est une boîte aux lettres qui est placée en conservation pour litige ou en conservation inaltérable avant d’être supprimée (réversible). Les valeurs valides sont les suivantes :

  • $true   La recherche ne tente pas de valider l’existence de la boîte aux lettres avant de poursuivre. Cette valeur est requise si vous voulez inclure des boîtes aux lettres inactives dans la recherche, car ces dernières ne sont pas résolues comme des boîtes aux lettres habituelles.

  • $false   La recherche tente de valider l’existence de la boîte aux lettres avant de poursuivre. Si vous indiquez une boîte aux lettres inactive ou introuvable, la recherche échoue. Il s’agit de la valeur par défaut.

Case

Facultatif

System.String

Le paramètre Case spécifie le nom d’un cas eDiscovery auquel la nouvelle recherche de conformité sera associée. Si la valeur contient des espaces, placez-la entre guillemets.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

ContentMatchQuery

Facultatif

System.String

Le paramètre ContentMatchQuery spécifie un filtre de recherche de contenu.

Ce paramètre utilise une chaîne de recherche de texte ou une requête formatée en utilisant la syntaxe KQL (Keyword Query Language). Pour plus d’informations sur la syntaxe KQL, consultez la rubrique Référence de syntaxe de langage de requête de mot clé (KQL).

Description

Facultatif

System.String

Le paramètre Description permet de fournir une description de la recherche de conformité (facultatif). Si la valeur contient des espaces, mettez le nom entre guillemets.

ExchangeLocation

Facultatif

System.String[]

Le paramètre ExchangeLocation spécifie les boîtes aux lettres à inclure. Les valeurs valides sont les suivantes :

  • Boîte aux lettres

  • Un groupe de distribution ou un groupe de sécurité à extension messagerie (toutes les boîtes aux lettres qui sont actuellement membres du groupe).

  • La valeur All pour toutes les boîtes aux lettres. Vous pouvez uniquement utiliser cette valeur seule.

Pour spécifier une boîte aux lettres ou un groupe de distribution, vous pouvez utiliser n’importe quelle valeur qui l’identifie de manière unique. Par exemple :

  • Nom

  • Nom unique

  • Adresse de messagerie

  • GUID

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

ExchangeLocationExclusion

Facultatif

System.String[]

Ce paramètre spécifie les boîtes aux lettres à exclure lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. Les valeurs valides sont les suivantes :

  • Boîte aux lettres

  • Un groupe de distribution ou un groupe de sécurité à extension messagerie (toutes les boîtes aux lettres qui sont actuellement membres du groupe).

Pour spécifier une boîte aux lettres ou un groupe de distribution, vous pouvez utiliser n’importe quelle valeur qui l’identifie de manière unique. Par exemple :

  • Nom

  • Nom unique

  • Adresse de messagerie

  • GUID

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

HoldNames

Facultatif

System.String[]

Le paramètre HoldNames indique que les emplacements de contenu soumis à une obligation de conservation légale dans le cas eDiscovery spécifié seront inclus dans la recherche. Vous utilisez la valeur All pour ce paramètre. Vous devez également spécifier le nom d’un cas eDiscovery à l’aide du paramètre Case.

De plus, si un emplacement de contenu est soumis à une obligation de conservation légale des cas basés sur des requêtes, seuls les éléments soumis à cette obligation seront inclus dans la recherche de conformité effectuée. Par exemple, si un utilisateur est soumis à une obligation de conservation légale des cas basés sur des requêtes qui conservent des éléments envoyés ou créés avant une certaine date, seuls ces éléments seraient inclus dans la recherche de conformité à l’aide des critères de recherche spécifiés.

Language

Facultatif

System.Globalization.CultureInfo

Le paramètre Language permet de définir la langue de la recherche de conformité.

Une entrée valide pour ce paramètre est une valeur de code de culture prise en charge de la classe CultureInfo Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez la rubrique relative à la classe CultureInfo.

LogLevel

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceJobLogLevel

Ce paramètre est réservé à l’usage interne chez Microsoft.

OneDriveLocation

Facultatif

System.String[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

OneDriveLocationExclusion

Facultatif

System.String[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

PublicFolderLocation

Facultatif

System.String[]

Le paramètre PublicFolderLocation indique que vous souhaitez inclure tous les dossiers publics dans la recherche. Vous devez utiliser la valeur All pour ce paramètre.

PublicFolderLocationExclusion

Facultatif

System.String[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

RefinerNames

Facultatif

System.String[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

SearchNames

Facultatif

System.String[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

SharePointLocation

Facultatif

System.String[]

Le paramètre SharePointLocation spécifie les sites SharePoint Online à inclure. Vous identifiez le site par sa valeur d’URL, ou vous pouvez utiliser la valeur All pour inclure tous les sites.

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

SharePointLocationExclusion

Facultatif

System.String[]

Ce paramètre spécifie les sites SharePoint Online à exclure lorsque vous utilisez la valeur All pour le paramètre SharePointLocation. Vous identifiez le site par sa valeur d’URL.

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

StatusMailRecipients

Facultatif

System.String[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: