Partager via


Set-ComplianceSearch

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

Utilisez l’applet de commande Set-ComplianceSearch pour modifier les recherches de conformité non exécutées dans Exchange Server 2016 ou version ultérieure et dans le portail de conformité Microsoft Purview.

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

Syntax

Set-ComplianceSearch
   [-Identity] <ComplianceSearchIdParameter>
   [-AddExchangeLocation <String[]>]
   [-AddExchangeLocationExclusion <String[]>]
   [-AddSharePointLocation <String[]>]
   [-AddSharePointLocationExclusion <String[]>]
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-Name <String>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-RemoveExchangeLocation <String[]>]
   [-RemoveExchangeLocationExclusion <String[]>]
   [-RemovePublicFolderLocation <String[]>]
   [-RemoveSharePointLocation <String[]>]
   [-RemoveSharePointLocationExclusion <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

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 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 utiliser cette applet de commande dans PowerShell de conformité de la sécurité & , 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

Set-ComplianceSearch -Identity "Project X" -ExchangeLocation All

Cet exemple montre comment modifier la recherche de conformité existante nommée Project X. L’étendue de la recherche Exchange est remplacée par toutes les boîtes aux lettres.

Exemple 2

Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $null

Cet exemple montre comment modifier une recherche de conformité existante associée à un cas eDiscovery dans le portail de conformité Microsoft Purview. L’étendue de la recherche passe de la recherche dans les boîtes aux lettres sélectionnées et les sites SharePoint à la recherche de tous les emplacements de contenu qui ont été mis en attente dans le cas eDiscovery.

Exemple 3

Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CN

Cet exemple montre comment modifier le paramètre de langue d’une recherche de conformité existante en chinois.

Vous devrez peut-être modifier le paramètre de langue si vous utilisez des mots clés non anglais dans la requête de recherche (qui est spécifiée dans le paramètre ContentMatchQuery).

Paramètres

-AddExchangeLocation

Le paramètre AddExchangeLocation spécifie les boîtes aux lettres à ajouter à la liste des boîtes aux lettres incluses lorsque vous n’utilisez pas la valeur All pour le paramètre ExchangeLocation. 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 Microsoft 365 utilisateurs invités) est contrôlée par le paramètre AllowNotFoundExchangeLocationsEnabled.
  • 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-AddExchangeLocationExclusion

Ce paramètre est fonctionnel uniquement dans Exchange local.

Ce paramètre spécifie les boîtes aux lettres à ajouter à la liste des boîtes aux lettres exclues lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. 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 Microsoft 365 utilisateurs invités) est contrôlée par le paramètre AllowNotFoundExchangeLocationsEnabled.
  • 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-AddSharePointLocation

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre AddSharePointLocation spécifie les sites SharePoint Online à ajouter à la liste des sites inclus lorsque vous n’utilisez pas la valeur All pour le paramètre SharePointLocation. Vous identifiez le site par sa valeur d’URL.

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".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationExclusion

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AllowNotFoundExchangeLocationsEnabled

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 n’essaie 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. Il s’agit de 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
  • Utilisateurs locaux dont l’identité est synchronisée avec votre organisation Microsoft 365
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Confirm

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-*) ont 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ContentMatchQuery

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocation

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 Microsoft 365 utilisateurs invités) 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.

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".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocationExclusion

Ce paramètre est fonctionnel 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 :

  • 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 Microsoft 365 utilisateurs invités) est contrôlée par le paramètre AllowNotFoundExchangeLocationsEnabled.
  • 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Force

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-HoldNames

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre HoldNames spécifie que les emplacements de contenu qui ont été mis en attente dans le cas eDiscovery feront l’objet d’une recherche. Vous utilisez la valeur All pour ce paramètre. Vous pouvez utiliser ce paramètre uniquement pour les recherches de conformité associées à un cas eDiscovery.

Si les emplacements de contenu dans la recherche de conformité incluent des boîtes aux lettres, vous devez également utiliser le paramètre ExchangeLocation avec la valeur $null. De même, si la recherche de conformité inclut des sites SharePoint, vous devez également utiliser le paramètre SharePointLocation avec la valeur $null.

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 nouvelle 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

Le paramètre Identity permet de définir la recherche de conformité que vous souhaitez modifier.

Lorsque vous utilisez ce paramètre, le paramètre Identity est obligatoire, mais la valeur est ignorée. Par exemple, utilisez la valeur 000 pour le paramètre Identity.

  • Nom
  • JobRunId (GUID)

JobRunId (GUID)

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-IncludeOrgContent

{{ Fill IncludeOrgContent Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeUserAppContent

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 standard Microsoft 365 dans votre organisation. 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 organisation Microsoft 365. Les valeurs valides sont les suivantes :

  • $true : l’emplacement de stockage cloud pour les utilisateurs spécifiés dans l’un des paramètres d’emplacement Exchange sera 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 sera inclus dans la recherche.
  • $false : l’emplacement de stockage cloud pour les utilisateurs spécifiés dans le paramètre ExchangeLocation ne sera pas inclus dans la recherche. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Language

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 Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez CultureInfo, classe.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-PublicFolderLocation

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RefinerNames

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

Le paramètre RemoveExchangeLocation spécifie les boîtes aux lettres à supprimer de la liste des boîtes aux lettres incluses lorsque vous n’utilisez pas la valeur All pour le paramètre ExchangeLocation. Les valeurs valides sont les suivantes :

  • Ce paramètre spécifie les boîtes aux lettres à supprimer de la liste des boîtes aux lettres exclues lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-RemoveExchangeLocationExclusion

Ce paramètre est fonctionnel uniquement dans Exchange local.

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

  • Ce paramètre spécifie les boîtes aux lettres à supprimer de la liste des boîtes aux lettres exclues lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-RemovePublicFolderLocation

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre RemoveSharePointLocation spécifie les sites SharePoint Online à supprimer de la liste des sites inclus lorsque vous n’utilisez pas la valeur All pour le paramètre SharePointLocation. Vous identifiez le site par sa valeur d’URL.

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".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationExclusion

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocation

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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.

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".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocationExclusion

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

Le commutateur WhatIf ne fonctionne pas dans PowerShell conformité de la sécurité & .

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance