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-ComplianceSearchAction

 

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

Dernière rubrique modifiée :2017-07-18

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-ComplianceSearchAction permet de créer des actions pour les recherches de conformité dans Exchange Server 2016 et dans le Centre de conformité et sécurité dans Office 365.

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

New-ComplianceSearchAction <COMMON PARAMETERS>

New-ComplianceSearchAction [-Preview <SwitchParameter>] <COMMON PARAMETERS>

New-ComplianceSearchAction [-ArchiveFormat <Unknown | SinglePst | PerUserPst | IndividualMessage | SingleZip | PerUserZip | SingleFolderPst>] [-EnableDedupe <$true | $false>] [-ExchangeArchiveFormat <Unknown | SinglePst | PerUserPst | IndividualMessage | SingleZip | PerUserZip | SingleFolderPst>] [-Export <SwitchParameter>] [-FileTypeExclusionsForUnindexedItems <String[]>] [-IncludeSharePointDocumentVersions <$true | $false>] [-MaxUnindexedSize <Int32>] [-NotifyEmail <String>] [-NotifyEmailCC <String>] [-Report <SwitchParameter>] [-RetentionReport <SwitchParameter>] [-Scope <Unknown | IndexedItemsOnly | UnindexedItemsOnly | BothIndexedAndUnindexedItems>] [-ScopeDetails <ComplianceScopeDetail[]>] [-SharePointArchiveFormat <Unknown | SinglePst | PerUserPst | IndividualMessage | SingleZip | PerUserZip | SingleFolderPst>] [-ShareRootPath <String>] <COMMON PARAMETERS>

New-ComplianceSearchAction [-Purge <SwitchParameter>] [-PurgeType <Unknown | SoftDelete>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-ActionName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Format <Unknown | FxStream | Mime | Msg | BodyText>] [-IncludeCredential <SwitchParameter>] [-JobOptions <Int32>] [-ReferenceActionName <String>] [-Region <String>] [-RetryOnError <SwitchParameter>] [-Scenario <Unknown | General | AnalyzeWithZoom | GenerateReportsOnly | Inventory | RetentionReports | TriagePreview>] [-SearchName <String[]>] [-SearchNames <String[]>] [-Version <String>] [-WhatIf [<SwitchParameter>]]

Cet exemple crée une action d’aperçu de recherche pour la recherche de conformité nommée Project X.

New-ComplianceSearchAction -SearchName "Project X" -Preview

Cet exemple crée une action d’exportation de recherche pour la recherche de conformité nommée Project X.

New-ComplianceSearchAction -SearchName "Project X" -Export

Cet exemple supprime les résultats de recherche renvoyés par une recherche de conformité nommée Remove Phishing Message. Notez que les éléments non indexés ne sont pas supprimés lorsque vous utilisez le paramètre Purge.

New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete

Après avoir créé une recherche de conformité à l’aide la cmdlet New-ComplianceSearch et l’avoir exécutée à l’aide de la cmdlet Start-ComplianceSearch, vous devez assigner une action à la recherche à l’aide de la cmdlet New-ComplianceSearchAction.

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 Obligatoire Type Description

ActionName

Facultatif

System.String

Le paramètre ActionName permet de définir le nom de la recherche de conformité. Utilisez ce paramètre uniquement lorsque vous définissez plusieurs recherches de conformité dans le paramètre SearchName.

ArchiveFormat

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceExportArchiveFormat

Le paramètre ArchiveFormat indique comment exporter les résultats de recherche Exchange. Les valeurs valides sont les suivantes :

  • PerUserPst   Un fichier PST pour chaque boîte aux lettres. Il s’agit de la valeur par défaut.

  • SinglePst   Un seul fichier PST contenant tous les messages exportés.

  • SingleFolderPst   Un fichier avec un dossier racine unique pour l’exportation complète.

  • IndividualMessage   Exporter chaque message sous forme de fichier au format .msg.

  • SingleZip   Un fichier ZIP qui contient des messages tout exportés.

  • PerUserZip   Un fichier ZIP pour chaque boîte aux lettres.

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.

EnableDedupe

Facultatif

System.Boolean

Le paramètre EnableDedupe évite l’existence de messages en double lorsque vous exportez des résultats de recherche de conformité. Les valeurs valides sont les suivantes :

  • $true   Permet d’exporter une seule copie d’un message si le même message existe dans plusieurs dossiers ou boîtes aux lettres.

  • $false   Permet d’exporter toutes les copies d’un message si le même message existe dans plusieurs dossiers ou boîtes aux lettres. Il s’agit de la valeur par défaut.

ExchangeArchiveFormat

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceExportArchiveFormat

Le paramètre ExchangeArchiveFormat spécifie comment exporter des résultats de la recherche Exchange. Les valeurs valides sont :

  • PerUserPst   Un fichier PST pour chaque boîte aux lettres. Il s’agit de la valeur par défaut.

  • SinglePst   Un seul fichier PST contenant tous les messages exportés.

  • SingleFolderPst   Un fichier avec un dossier racine unique pour l’exportation complète.

  • IndividualMessage   Exporter chaque message sous forme de fichier au format .msg.

  • SingleZip   Un fichier ZIP qui contient exportés tous les messages, en utilisant le format .msg.

  • PerUserZip   Un fichier ZIP pour chaque boîte aux lettres.

Export

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Export indique que l’action définie pour la recherche de conformité consiste à exporter l’ensemble des résultats répondant aux critères de recherche. Il n’est pas nécessaire d’indiquer une valeur pour ce commutateur.

Pour renvoyer uniquement les informations relatives à chaque élément détecté dans un rapport, utilisez le commutateur Report.

FileTypeExclusionsForUnindexedItems

Facultatif

System.String[]

Le paramètre FileTypeExclusionsForUnindexedItems spécifie les types de fichiers à exclure car ils ne peuvent pas être indexés. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

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.

Format

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceDataTransferFormat

Le paramètre Format spécifie le format des résultats de recherche lorsque vous utilisez le commutateur Export. Les valeurs valides sont les suivantes :

  • FxStream   Exporter vers des fichiers PST. Il s’agit de la seule option disponible lorsque vous exportez des résultats de recherche à partir du Centre de conformité et sécurité.

  • Mime   Exporter des fichiers de messages .eml. Il s’agit de la valeur par défaut lorsque vous utilisez des cmdlets pour exporter les résultats de recherche.

  • Message   Exporter des fichiers de message .msg.

  • BodyText   Exporter les fichiers .txt.

IncludeCredential

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeCredential précise si des informations détaillées doivent être incluses dans les résultats. Il n’est pas nécessaire de spécifier une valeur avec ce commutateur.

IncludeSharePointDocumentVersions

Facultatif

System.Boolean

Le paramètre IncludeSharePointDocumentVersions spécifie si les versions précédentes du document doivent être exportées lorsque vous utilisez le commutateur Export. Les valeurs valides sont les suivantes :

  • $true   Exporter toutes les versions du document.

  • $false   Exporter uniquement la version publiée actuelle de la rubrique. Il s’agit de la valeur par défaut.

JobOptions

Facultatif

System.Int32

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

MaxUnindexedSize

Facultatif

System.Int32

Le paramètre MaxUnindexedSize spécifie la taille maximale en octets pour les éléments non indexés. Une valeur valide est un nombre entier.

NotifyEmail

Facultatif

System.String

Le paramètre NotifyEmail spécifie la cible d’adresse de messagerie pour les résultats de recherche lorsque vous utilisez le commutateur Export.

Le destinataire que vous spécifiez se trouve dans le champ To: du message.

NotifyEmailCC

Facultatif

System.String

Le paramètre NotifyEmailCC spécifie la cible d’adresse de messagerie pour les résultats de recherche lorsque vous utilisez le commutateur Export.

Le destinataire que vous spécifiez se trouve dans le champ Cc: du message.

Preview

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Preview indique que l’action définie pour la recherche de conformité est de prévisualiser les résultats répondant aux critères de recherche. Il n’est pas nécessaire de spécifier de valeur pour ce commutateur.

Purge

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Purge indique que l’action définie pour la recherche de conformité est de supprimer les éléments répondant aux critères de recherche. Il n’est pas nécessaire de spécifier de valeur pour ce commutateur.

Remarque : un maximum de 10 éléments par boîte aux lettres peuvent être supprimés à la fois. Sachant que la fonction de recherche et de suppression de messages est censée être un outil de réponse aux incidents, cette limite permet de s’assurer que les messages sont rapidement supprimés des boîtes aux lettres. Cette action n’est pas conçue pour nettoyer les boîtes aux lettres des utilisateurs.

En outre, les éléments non indexés ne sont pas supprimés des boîtes aux lettres lorsque vous utilisez ce commutateur.

PurgeType

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceDestroyType

Le paramètre PurgeType permet de définir la méthode de suppression des éléments lorsque l’action est Purge.

La valeur valide pour ce paramètre est SoftDelete, qui signifie que les éléments purgés peuvent être récupérés par les utilisateurs jusqu’à l’expiration de leur période de rétention.

ReferenceActionName

Facultatif

System.String

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

Region

Facultatif

System.String

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

Report

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Report indique que l’action définie pour la recherche de la conformité consiste à exporter un rapport sur les résultats (informations sur chaque élément et non sur l’ensemble des résultats) répondant aux critères de recherche. Il n’est pas nécessaire d’indiquer une valeur pour ce commutateur.

RetentionReport

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur RetentionReport indique que l’action définie pour la recherche de conformité est d’exporter un rapport de rétention. Il n’est pas nécessaire de spécifier de valeur pour ce commutateur.

RetryOnError

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur RetryOnError permet d’indiquer si l’action doit être relancée sur les éléments qui ont échoué, sans réexécuter l’action en entier. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Scenario

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceSearchActionScenario

Le paramètre Scenario spécifie le type de scénario lorsque vous utilisez le commutateur Export. Les valeurs valides sont les suivantes :

  • AnalyzeWithZoom   Préparer les résultats de recherche pour le traitement dans eDiscovery (découverte électronique) avancée Office 365.

  • General   Exporter les résultats de recherche vers l’ordinateur local. Les messages électroniques sont exportés vers des fichiers .pst. Les documents SharePoint et OneDrive Entreprise sont exportés dans leur format Office natif.

  • GenerateReportsOnly

  • Inventory

  • RetentionReports

  • TriagePreview

Scope

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceExportScope

Le paramètre Scope permet de définir les éléments à inclure lorsque l’action est Export. Les valeurs valides sont les suivantes :

  • IndexedItemsOnly

  • UnindexedItemsOnly

  • BothIndexedAndUnindexedItems

Ce paramètre n’est significatif pour les recherches de conformité que si le paramètre IncludeUnindexedItemsEnabled est défini sur $true.

ScopeDetails

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceScopeDetail[]

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

SearchName

Facultatif

System.String[]

Le paramètre SearchName permet de définir le nom de la recherche de conformité existante à associer à l’action de recherche de conformité. Vous pouvez définir plusieurs recherches de conformité en les séparant par des virgules.

Vous trouverez la recherche de la conformité en exécutant la commande Get-ComplianceSearch | Format-Table -Auto Name,Status.

SearchNames

Facultatif

System.String[]

Le paramètre SearchNames spécifie les noms des recherches respect de la réglementation existante à associer à l’action de recherche de la conformité. Vous séparez les noms de searche de la conformité par des virgules.

Vous pouvez trouver les noms de recherche de la conformité en exécutant la commande Get-ComplianceSearch | Format-Table -Auto Name,Status.

SharePointArchiveFormat

Facultatif

Microsoft.Exchange.Compliance.TaskDistributionCommon.ObjectModel.ComplianceExportArchiveFormat

Le paramètre SharePointArchiveFormat spécifie comment exporter des résultats de la recherche SharePoint. Les valeurs valides sont :

  • PerUserPst   Un fichier pour chaque utilisateur. Il s’agit de la valeur par défaut.

  • SinglePst   Un fichier qui contient les fichiers exportés tous les.

  • SingleFolderPst   Un fichier avec un dossier racine unique pour l’exportation complète.

  • IndividualMessage   Exporter chaque fichier à un message en utilisant le format .msg.

  • SingleZip   Un fichier ZIP qui contient les fichiers tout exportés.

  • PerUserZip   Un fichier ZIP pour chaque utilisateur.

ShareRootPath

Facultatif

System.String

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

Version

Facultatif

System.String

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

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre ne fonctionne pas dans Centre de conformité et sécurité dans Office 365.

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.

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: