Partager via

Get-ComplianceSearch

Module:
Exchange PowerShell

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-ComplianceSearch pour afficher les recherches d’estimation de conformité dans Exchange Server 2016 ou version ultérieure et dans le portail de conformité Microsoft Purview. Après avoir utilisé la cmdlet New-ComplianceSearchAction pour définir une action de prévisualisation pour la recherche de conformité, utilisez la cmdlet Get-ComplianceSearchAction pour afficher les résultats de celle-ci.

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

Syntaxe

Default (Par défaut) 

Get-ComplianceSearch
    [[-Identity] <ComplianceSearchIdParameter>]
    [-Case <String>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

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

Cet exemple affiche la liste récapitulative de toutes les recherches de conformité.

Exemple 2

Get-ComplianceSearch -Identity "Case 1234" | Format-List

Cet exemple présente les détails de la recherche de conformité nommée Case 1234.

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 en fonction du nom d’une Standard cas auquel la recherche de conformité est associée. Si la valeur contient des espaces, mettez le nom entre guillemets.

Vous ne pouvez pas utiliser ce paramètre pour afficher les recherches de conformité associées aux cas eDiscovery Premium.

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

-DomainController

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

-Identity

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité

Le paramètre Identity permet de définir la recherche de conformité que vous voulez afficher.

Lorsque vous utilisez ce paramètre, le paramètre Identity est obligatoire, mais la valeur est ignorée. Par exemple, utilisez la valeur 000 pour le paramètre Identity.

  • Nom
  • JobRunId (GUID)

JobRunId (GUID)

Pour améliorer les performances de cette applet de commande, certaines propriétés de recherche de conformité ne sont pas retournées si vous ne spécifiez pas l’identité de la recherche de conformité. Ces propriétés sont les suivantes :

  • Éléments
  • Taille
  • SuccessResults
  • NumBindings
  • ExchangeLocation
  • SharePointLocation
  • OneDriveLocation

Pour afficher ces propriétés, vous devez utiliser le paramètre Identity dans la commande .

Remarque : la propriété NumBindings 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.

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:ComplianceSearchIdParameter
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:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
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.