Get-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 Get-ComplianceSearchAction pour afficher des informations sur les actions de recherche de conformité.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Identity
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Preview
Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Purge
Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Export
Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Après avoir créé et exécuté une recherche de conformité à l’aide de la cmdlet New-ComplianceSearch, et l’avoir lancée à l’aide de la cmdlet Start-ComplianceSearch, vous devez attribuer une action à l’aide de la cmdlet New-ComplianceSearchAction. La cmdlet Get-ComplianceSearchAction permet de suivre la progression de l’action de recherche de conformité.
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
Get-ComplianceSearchAction
Cet exemple affiche la liste récapitulative de toutes les actions de recherche de conformité.
Exemple 2
Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List
Cet exemple affiche les détails de l’action de recherche de conformité nommée Case 1234_Preview.
Paramètres
-Case
Applicable : Sécurité & Conformité
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre Case filtre les résultats par le nom du cas spécifié. Si la valeur contient des espaces, mettez le nom entre guillemets.
Propriétés des paramètres
| 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 |
-Details
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le commutateur Details 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 pour ce commutateur.
Propriétés des paramètres
| 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 |
-DomainController
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Ce paramètre est disponible uniquement dans Exchange local.
Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».
Propriétés des paramètres
| Type: | Fqdn |
| 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 |
-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.
Le commutateur Export filtre les résultats en fonction des actions de recherche de conformité Export. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous ne pouvez pas utiliser ce commutateur avec les paramètres Identity, Preview ou Purge.
Propriétés des paramètres
| 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 |
-Identity
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le paramètre Identity permet de définir l’action de recherche de conformité à afficher. Vous pouvez utiliser n’importe quelle valeur qui permet d’identifier l’action de recherche de conformité de façon unique. Par exemple :
- Nom : le nom de l’action de recherche de conformité utilise la syntaxe
"Compliance Search Name_Action". Par exemple :"Case 1234_Preview". - JobRunId (GUID)
Vous ne pouvez pas utiliser ce paramètre avec les paramètres Export, Preview ou Purge.
Lorsque vous utilisez le paramètre Identity, plus de détails sont retournés dans les résultats. Par exemple :
- Dans la ligne Résultats, les valeurs des propriétés Nombre d’éléments, Taille totale et Détails sont renseignées.
- Les lignes d’emplacement sont ajoutées aux résultats.
- La valeur de la propriété NumBindings est renseignée. Cette propriété inclut la boîte aux lettres principale, l’archive principale et toutes les archives supplémentaires pour les utilisateurs inclus dans la recherche. NumBindings n’est pas le nombre d’utilisateurs inclus dans la recherche, car chaque utilisateur inclus peut avoir ou non une combinaison d’une boîte aux lettres principale, d’une archive principale et d’archives supplémentaires.
- Les propriétés d’emplacement affectées (par exemple, ExchangeLocation) sont renseignées.
- La valeur de la propriété CaseName est renseignée.
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | ComplianceSearchActionIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| 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 des paramètres
| 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 |
-Organization
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 des paramètres
| Type: | OrganizationIdParameter |
| 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 |
-Preview
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le commutateur Preview filtre les résultats en fonction des actions de recherche de conformité Prévisualiser. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous ne pouvez pas utiliser ce commutateur avec les paramètres Exporter, Identité ou Purger.
Propriétés des paramètres
| 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 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 commutateur Purge filtre les résultats en fonction des actions de recherche de conformité Purger. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous ne pouvez pas utiliser ce commutateur avec les paramètres Exporter, Identité ou Préversion.
Propriétés des paramètres
| 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 |
-ResultSize
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.
Propriétés des paramètres
| Type: | Unlimited |
| 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 |
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.