New-ComplianceSearch
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’autre.
Utilisez l’applet de commande New-ComplianceSearch pour créer des recherches de conformité dans Exchange Server 2016 ou version ultérieure et dans le portail de conformité Microsoft Purview. 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 Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
New-ComplianceSearch
[-Name] <String>
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Case <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-LogLevel <ComplianceJobLogLevel>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-StatusMailRecipients <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Une recherche de conformité nécessite au moins un emplacement. Par exemple, les boîtes aux lettres utilisant le paramètre ExchangeLocation ou les sites SharePoint utilisant le 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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Dans Exchange local, cette applet de commande est disponible dans le rôle Recherche de boîtes aux lettres. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestion de la découverte.
Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 1
New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"
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.
Exemple 2
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 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.
Exemple 3
New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true
Cet exemple crée une recherche de conformité nommée AnnBeebe-InactiveMailbox qui recherche une boîte aux lettres inactive et retourne tous les éléments de la boîte aux lettres. Pour rechercher des boîtes aux lettres inactives, vous devez utiliser l’adresse SMTP principale de la boîte aux lettres inactive, précédée d’un point (« . »). 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.
Paramètres
-AllowNotFoundExchangeLocationsEnabled
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Le paramètre AllowNotFoundExchangeLocationsEnabled spécifie s’il faut inclure des boîtes aux lettres autres que des boîtes aux lettres utilisateur standard dans la recherche de conformité. Les valeurs valides sont les suivantes :
- $true : la recherche ne tente pas de valider l’existence de la boîte aux lettres avant de continuer. Cette valeur est requise si vous souhaitez rechercher des boîtes aux lettres qui ne sont pas résolues en tant que boîtes aux lettres standard.
- $false : la recherche tente de valider l’existence de la boîte aux lettres avant de continuer. Si vous spécifiez une boîte aux lettres qui n’est pas une boîte aux lettres utilisateur normale, la recherche échoue. Cette valeur est la valeur par défaut.
Les types de boîtes aux lettres affectés par la valeur de ce paramètre sont les suivants :
- Boîtes aux lettres inactives
- Utilisateurs sans licence Exchange Online qui utilisent des applications Office
- Utilisateurs invités Microsoft 365
- Utilisateurs locaux dont l’identité est synchronisée avec votre organization Microsoft 365
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Case
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre Case spécifie le nom d’une Standard cas eDiscovery à laquelle associer la nouvelle recherche de conformité. Si la valeur contient des espaces, mettez le nom entre guillemets.
Vous ne pouvez pas utiliser ce paramètre pour créer des recherches de conformité associées à des cas eDiscovery Premium.
Si le paramètre Name contient des espaces, la valeur du paramètre ExchangeLocation est effacée lorsque vous utilisez le paramètre Case.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ContentMatchQuery
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
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, consultez Informations de référence sur la syntaxe KQL (Keyword Query Language) et Requêtes par mot clé et conditions de recherche pour eDiscovery.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Description
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExchangeLocation
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Le paramètre ExchangeLocation spécifie les boîtes aux lettres à inclure. Les valeurs valides sont les suivantes :
- Boîte aux lettres d’utilisateur standard. L’inclusion d’autres types de boîtes aux lettres (par exemple, les boîtes aux lettres inactives ou les utilisateurs invités Microsoft 365) est contrôlée par le paramètre AllowNotFoundExchangeLocationsEnabled.
- Boîte aux lettres
- Valeur All pour toutes les boîtes aux lettres. Cette valeur ne peut être utilisée que seule.
Pour spécifier une boîte aux lettres ou un groupe de distribution, utilisez l’adresse e-mail. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ExchangeLocationExclusion
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Ce paramètre est disponible uniquement dans Exchange local.
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 :
- Le paramètre ExchangeLocation permet de définir les boîtes aux lettres à inclure dans la stratégie. Les valeurs valides sont les suivantes :
- Boîte aux lettres
Pour spécifier une boîte aux lettres ou un groupe de distribution, utilisez l’adresse e-mail. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-HoldNames
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre HoldNames spécifie les emplacements de contenu placés en attente dans le cas eDiscovery spécifié dans lequel la recherche est effectuée. Vous devez utiliser la valeur All pour ce paramètre. Vous devez également spécifier le nom d’un cas eDiscovery à l’aide du paramètre Case.
En outre, si un emplacement de contenu a été placé sur une conservation de cas basée sur une requête, seuls les éléments en attente font l’objet d’une recherche lorsque vous exécutez cette recherche de conformité. 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IncludeOrgContent
Applicable : Sécurité & Conformité
{{ Fill IncludeOrgContent Description }}
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IncludeUserAppContent
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre IncludeUserAppContent spécifie que vous souhaitez rechercher dans l’emplacement de stockage cloud les utilisateurs qui n’ont pas de compte d’utilisateur Microsoft 365 standard dans votre organization. Ces types d’utilisateurs incluent les utilisateurs sans licence Exchange Online qui utilisent des applications Office, les utilisateurs invités Microsoft 365 et les utilisateurs locaux dont l’identité est synchronisée avec votre organization Microsoft 365. Les valeurs valides sont les suivantes :
- $true : l’emplacement de stockage cloud pour les utilisateurs spécifiés dans le paramètre ExchangeLocation est inclus dans la recherche. Si vous utilisez la valeur All pour le paramètre ExchangeLocation, l’emplacement de stockage cloud de tout utilisateur invité ou local est inclus dans la recherche.
- $false : l’emplacement de stockage cloud pour les utilisateurs spécifiés dans le paramètre ExchangeLocation n’est pas inclus dans la recherche. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Language
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Le paramètre Language permet de définir la langue de la recherche de conformité.
L’entrée valide pour ce paramètre est une valeur de code de culture prise en charge à partir de la classe CultureInfo de Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez Classe CultureInfo.
Propriétés du paramètre
| Type: | CultureInfo |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LogLevel
Applicable : Exchange Server 2016, Exchange Server 2019
Ce paramètre est disponible uniquement dans Exchange sur site.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | ComplianceJobLogLevel |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Le paramètre Name spécifie le nom de la recherche de conformité. Si la valeur contient des espaces, mettez le nom entre guillemets.
N’utilisez pas d’espaces dans la valeur de ce paramètre si vous envisagez d’utiliser le paramètre Case. Si le paramètre Name contient des espaces, la valeur du paramètre ExchangeLocation est effacée lorsque vous utilisez le paramètre Case.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PublicFolderLocation
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RefinerNames
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SharePointLocation
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre SharePointLocation spécifie les sites SharePoint à inclure. Vous identifiez le site par sa valeur d’URL, ou vous pouvez utiliser la valeur All pour inclure tous les sites.
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SharePointLocationExclusion
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-StatusMailRecipients
Applicable : Exchange Server 2016, Exchange Server 2019
Ce paramètre est disponible uniquement dans Exchange sur site.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2016, Exchange Server 2019, Sécurité & Conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.