Partager via

Get-ComplianceSearchAction

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Server 2016, Exchange Server 2019, Security & Compliance

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

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