New-ComplianceSearchAction
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-ComplianceSearchAction pour créer des actions pour les recherches de contenu dans Exchange Server 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.
Syntaxe
Export
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Export]
[-ActionName <String>]
[-ArchiveFormat <ComplianceExportArchiveFormat>]
[-Confirm]
[-FileTypeExclusionsForUnindexedItems <String[]>]
[-EnableDedupe <Boolean>]
[-ExchangeArchiveFormat <ComplianceExportArchiveFormat>]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-IncludeSharePointDocumentVersions <Boolean>]
[-JobOptions <Int32>]
[-NotifyEmail <String>]
[-NotifyEmailCC <String>]
[-ReferenceActionName <String>]
[-Region <String>]
[-Report]
[-RetentionReport]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-Scope <ComplianceExportScope>]
[-SearchNames <String[]>]
[-SharePointArchiveFormat <ComplianceExportArchiveFormat>]
[-ShareRootPath <String>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Preview
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Preview]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-ReferenceActionName <String>]
[-Region <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Purge
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Purge]
[-PurgeType <ComplianceDestroyType>]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-Region <String>]
[-ReferenceActionName <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Description
Après avoir créé une recherche de contenu à l’aide de l’applet de commande New-ComplianceSearch et l’avoir exécutée à l’aide de l’applet de commande Start-ComplianceSearch, vous affectez une action de recherche à la recherche à l’aide de l’applet de commande New-ComplianceSearchAction.
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.
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 Microsoft 365, une licence Microsoft 365 valide doit être attribuée au compte que vous utilisez pour exécuter cette applet de commande.
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.
Pour utiliser cette applet de commande pour les actions de purge dans PowerShell sécurité & conformité, vous devez respecter les exigences suivantes :
- Utilisez le Exchange Online PowerShell version 3.9.0 ou ultérieure (août 2025). Pour plus d’informations, consultez Nouveautés du module PowerShell Exchange Online. L’installation de cette version du module peut nécessiter l’utilisation de toutes les versions précédentes du module.
- Exécutez la commande Connect-IPPSSession avec le commutateur EnableSearchOnlySession .
Exemples
Exemple 1
New-ComplianceSearchAction -SearchName "Project X" -Preview
Cet exemple crée une action de recherche d’aperçu pour la recherche de contenu nommée Project X.
Exemple 2
New-ComplianceSearchAction -SearchName "Project X" -Export
Cet exemple crée une action de recherche d’exportation pour la recherche de contenu nommée Project X.
Remarque : Après le 26 mai 2025, cet exemple ne fonctionne plus. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Exemple 3
New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete
Cet exemple supprime les résultats de recherche retournés par une recherche de contenu nommée Supprimer le message d’hameçonnage. Les éléments non indexés ne sont pas supprimés lorsque vous utilisez le paramètre Purge.
Exemple 4
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream
Cet exemple exporte les résultats retournés par la recherche de contenu nommée « Cas 321 Tous les sites ». Les résultats de la recherche sont compressés et exportés vers un seul fichier ZIP. Si la recherche incluait des emplacements Exchange, les résultats de la recherche sont exportés sous la forme d’un fichier PST par boîte aux lettres.
Remarque : Après le 26 mai 2025, cet exemple ne fonctionne plus. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Paramètres
-ActionName
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre ActionName spécifie un nom pour l’action de recherche de contenu. Vous utilisez ce paramètre uniquement lorsque vous spécifiez plusieurs recherches de contenu dans le paramètre SearchName.
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 |
-ArchiveFormat
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Ce paramètre est déconseillé et n’est plus utilisé.
Pour spécifier le format des résultats de recherche Exchange, utilisez le paramètre ExchangeArchiveFormat. Pour spécifier le format des résultats de recherche SharePoint et OneDrive, utilisez le paramètre SharePointArchiveFormat.
Propriétés du paramètre
| Type: | ComplianceExportArchiveFormat |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Export
| 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, Exchange Server SE, 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.
Cette applet de commande a une pause intégrée. Utilisez -Confirm:$false donc pour ignorer la confirmation.
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 |
-EnableDedupe
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: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExchangeArchiveFormat
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre nécessite le rôle Exporter dans Security & Compliance PowerShell. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
Le paramètre ExchangeArchiveFormat spécifie comment exporter les résultats de recherche Exchange. Les valeurs valides sont les suivantes :
- PerUserPst : un fichier PST pour chaque boîte aux lettres.
- SinglePst : un fichier PST qui contient tous les messages exportés.
- SingleFolderPst : un fichier PST avec un dossier racine unique pour l’exportation entière.
- IndividualMessage : exportez chaque message en tant que fichier de message .msg. Cette valeur est la valeur par défaut.
- PerUserZip : un fichier ZIP pour chaque boîte aux lettres. Chaque fichier ZIP contient les fichiers de messages .msg exportés à partir de la boîte aux lettres.
- SingleZip : un fichier ZIP pour toutes les boîtes aux lettres. Le fichier ZIP contient tous les fichiers de messages .msg exportés à partir de toutes les boîtes aux lettres. Ce paramètre de sortie est disponible uniquement dans PowerShell.
Pour spécifier le format des résultats de recherche SharePoint et OneDrive, utilisez le paramètre SharePointArchiveFormat.
Propriétés du paramètre
| Type: | ComplianceExportArchiveFormat |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Export
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre nécessite le rôle Exporter dans Security & Compliance PowerShell. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
Le commutateur Exporter spécifie que l’action de la recherche de contenu consiste à exporter l’ensemble complet des résultats qui correspondent aux critères de recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Pour renvoyer uniquement les informations relatives à chaque élément détecté dans un rapport, utilisez le commutateur Report.
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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FileTypeExclusionsForUnindexedItems
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
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.
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
Export
| 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, Exchange Server SE, 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 |
-Format
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Dans PowerShell Sécurité & Conformité, ce paramètre nécessite le rôle Exporter. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
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 les résultats de la recherche à partir du portail de conformité Microsoft Purview.
- Mime : exporter vers .eml fichiers de message. Il s’agit de la valeur par défaut lorsque vous utilisez des cmdlets pour exporter les résultats de recherche.
- Msg : Exporter vers .msg fichiers de message.
Propriétés du paramètre
| Type: | ComplianceDataTransferFormat |
| 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 |
-IncludeCredential
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le commutateur IncludeCredential spécifie s’il faut inclure les informations d’identification dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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 |
-IncludeSharePointDocumentVersions
Applicable : Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
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 : exportez uniquement la version publiée actuelle du document. 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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-JobOptions
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Int32 |
| 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 |
-NotifyEmail
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Dans PowerShell Sécurité & Conformité, ce paramètre nécessite le rôle Exporter. Par défaut, ce n’est attribué qu’au groupe de rôles Gestionnaire eDiscovery.
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.
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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-NotifyEmailCC
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Dans PowerShell Sécurité & Conformité, ce paramètre nécessite le rôle Exporter. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
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.
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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Preview
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Dans Security & Compliance PowerShell, ce paramètre nécessite le rôle Préversion. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
Le commutateur Aperçu spécifie que l’action de la recherche de contenu consiste à afficher un aperçu des résultats qui correspondent aux critères de recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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
Preview
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Purge
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Dans Security & Compliance PowerShell, ce commutateur est disponible uniquement dans le rôle Rechercher et vider. Par défaut, ce rôle est attribué uniquement aux groupes de rôles Gestion de l’organisation et Enquêteur de données.
Le commutateur Vider spécifie que l’action de la recherche de contenu consiste à supprimer les éléments qui correspondent aux critères de recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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.
Conseil : pour vider plus de 10 éléments, reportez-vous à ediscoverySearch : purgeData dans microsoft API Graph, ce qui permet de vider un maximum de 100 éléments par emplacement.
Vous pouvez supprimer des éléments d’un maximum de 50 000 boîtes aux lettres à l’aide d’une seule recherche de contenu. Pour supprimer des éléments de plus de 50 000 boîtes aux lettres, vous devez créer des recherches de contenu distinctes. Pour plus d’informations, consultez Rechercher et supprimer des messages électroniques dans votre organization Microsoft 365.
Les éléments non indexés ne sont pas supprimés des boîtes aux lettres lorsque vous utilisez ce commutateur.
La valeur du paramètre PurgeType contrôle la façon dont les éléments sont supprimés.
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
Purge
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PurgeType
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Dans Security & Compliance PowerShell, ce paramètre est disponible uniquement dans le rôle Rechercher et vider. Par défaut, ce rôle est attribué uniquement aux groupes de rôles Gestion de l’organisation et Enquêteur de données.
Le paramètre PurgeType permet de définir la méthode de suppression des éléments lorsque l’action est Purge. Les valeurs valides sont les suivantes :
- SoftDelete : les éléments vidés peuvent être récupérés par les utilisateurs jusqu’à l’expiration de la période de rétention des éléments supprimés.
- HardDelete (cloud uniquement) : les éléments vidés sont marqués pour une suppression définitive de la boîte aux lettres et sont supprimés définitivement la prochaine fois que la boîte aux lettres est traitée par l’Assistant Dossier managé. Si la récupération d’élément unique est activée sur la boîte aux lettres, les éléments vidés sont supprimés définitivement après l’expiration de la période de rétention des éléments supprimés.
Propriétés du paramètre
| Type: | ComplianceDestroyType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Purge
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ReferenceActionName
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
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 |
-Region
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
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 |
-Report
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le commutateur Rapport spécifie que l’action de la recherche de contenu consiste à exporter un rapport sur les résultats (informations sur chaque élément au lieu de l’ensemble complet des résultats) qui correspondent aux critères de recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetentionReport
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Le commutateur RetentionReport spécifie que l’action de la recherche de contenu consiste à exporter un rapport de rétention. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetryOnError
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
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.
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 |
-Scenario
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Dans Security & Compliance PowerShell, ce paramètre nécessite le rôle Préversion. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
Le paramètre Scenario spécifie le type de scénario. Les valeurs valides sont les suivantes :
- AnalyzeWithZoom : préparez les résultats de la recherche pour le traitement dans Microsoft Purview eDiscovery Premium.
- Général : exporte les résultats de la recherche vers l’ordinateur local. Les messages électroniques sont exportés vers des fichiers .pst. Les documents SharePoint et OneDrive sont exportés dans leurs formats Office natifs.
- GenerateReportsOnly
- Inventaire
- RetentionReports
- TriagePreview
Propriétés du paramètre
| Type: | ComplianceSearchActionScenario |
| 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 |
-Scope
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
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
Propriétés du paramètre
| Type: | ComplianceExportScope |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SearchName
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le paramètre SearchName spécifie le nom de la recherche de contenu existante à associer à l’action de recherche de contenu. Vous pouvez spécifier plusieurs recherches de contenu séparées par des virgules.
Vous pouvez trouver la recherche de contenu en exécutant la commande Get-ComplianceSearch | Format-Table -Nom automatique,État.
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 |
-SearchNames
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre SearchNames spécifie les noms des recherches de contenu existantes à associer à l’action de recherche de contenu. Vous séparez les noms de recherche de contenu par des virgules.
Vous pouvez trouver des noms de recherche de contenu en exécutant la commande Get-ComplianceSearch | Format-Table -Nom automatique,État.
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 |
-SharePointArchiveFormat
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre nécessite le rôle Exporter. Par défaut, ce rôle est attribué uniquement au groupe de rôles Gestionnaire eDiscovery.
Le paramètre SharePointArchiveFormat spécifie comment exporter les résultats de recherche SharePoint et OneDrive. Les valeurs valides sont les suivantes :
- IndividualMessage : exportez les fichiers non compressés. Cette valeur est la valeur par défaut.
- PerUserZip : un fichier ZIP pour chaque utilisateur. Chaque fichier ZIP contient les fichiers exportés pour l’utilisateur.
- SingleZip : un fichier ZIP pour tous les utilisateurs. Le fichier ZIP contient tous les fichiers exportés de tous les utilisateurs. Ce paramètre de sortie est disponible uniquement dans PowerShell.
Pour spécifier le format des résultats de recherche Exchange, utilisez le paramètre ExchangeArchiveFormat.
Propriétés du paramètre
| Type: | ComplianceExportArchiveFormat |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ShareRootPath
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange sur site.
Remarque : Après le 26 mai 2025, ce paramètre n’est plus fonctionnel. Pour plus d’informations, consultez Modifications à venir apportées à Microsoft Purview eDiscovery.
{{ Fill ShareRootPath Description }}
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
Export
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Version
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
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, Exchange Server SE, Sécurité & Conformité
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
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.
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.