Get-ComplianceSearchAction
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 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.
Syntax
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-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 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
Get-ComplianceSearchActionCet exemple affiche la liste récapitulative de toutes les actions de recherche de conformité.
Exemple 2
Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-ListCet exemple affiche les détails de l’action de recherche de conformité nommée Case 1234_Preview.
Paramètres
-Case
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Details
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.
| 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 |
-DomainController
Ce paramètre est disponible uniquement dans Exchange sur site.
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 ».
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Export
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.
| 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 |
-Identity
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é NumBinding est renseignée.
- Les propriétés d’emplacement affectées (par exemple, ExchangeLocation) sont renseignées.
- La valeur de la propriété CaseName est renseignée.
| Type: | ComplianceSearchActionIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-IncludeCredential
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.
| 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 |
-Preview
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.
| 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 |
-Purge
Remarque : Dans PowerShell conformité de la sécurité & , 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.
| 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 |
-ResultSize
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.
| Type: | Unlimited |
| 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 |