Get-MailboxSearch

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-MailboxSearch permet d’afficher les recherches de boîte aux lettres en cours, terminées ou interrompues.

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

Get-MailboxSearch [-Identity <EwsStoreObjectIdParameter>] <COMMON PARAMETERS>

Get-MailboxSearch -InPlaceHoldIdentity <String> <COMMON PARAMETERS>

COMMON PARAMETERS: [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-ShowDeletionInProgressSearches <SwitchParameter>]

Cet exemple obtient la liste de toutes les recherches de boîtes aux lettres.

Get-MailboxSearch -ResultSize "unlimited"

Cet exemple récupère toutes les propriétés de la recherche de boîtes aux lettres intitulée Project Hamilton.

Get-MailboxSearch "Project Hamilton" | FL
noteRemarque :
Le paramètre Identity est un paramètre positionnel. Les paramètres de position peuvent être utilisés sans l’étiquette (Identité). Pour plus d’informations sur les paramètres de position, voir Paramètres.

Cet exemple permet d’obtenir des In-Place Holds attribuées à un utilisateur. La commande suivante permet d’obtenir des GUID In-Place Holds.

(Get-Mailbox Mark).InPlaceHolds

Les commandes suivantes permettent d’effectuer une recherche dans une boîte aux lettres, compte tenu du GUID et du In-Place Hold.

Get-MailboxSearch -InPlaceHoldIdentity 9953d0f0fd03415e949d4b41c5a28cbb

Dans les organisations Exchange locales et Exchange Online, une recherche de boîtes aux lettres permet d’effectuer une découverte électronique inaltérable ou de placer les utilisateurs en conservation inaltérable. Utilisez la cmdlet Get-MailboxSearch pour extraire les paramètres, quel que soit le type de recherche menée sur une boîte aux lettres.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir entrée « In-Place eDiscovery » dans la rubrique Stratégie de messagerie et autorisations de conformité dans Exchange 2016.

 

Paramètre Obligatoire Type Description

InPlaceHoldIdentity

Requis

System.String

Le paramètre InPlaceHoldIdentity permet de définir le GUID d’un In-Place Hold. Utilisez ce paramètre pour rechercher steph In-place Hold. Les GUID de toutes les conservations inaltérables dans lesquelles un utilisateur est placé sont rajoutés à la propriété InPlaceHolds de l’utilisateur. Vous pouvez récupérer l’information au moyen de la cmdlet Get-Mailbox.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.EwsStoreObjectIdParameter

Le paramètre Identity spécifie le nom de la requête de recherche. Si aucun nom n’est fourni, toutes les requêtes de recherche de boîte aux lettres sont renvoyées.

Pour améliorer les performances de cette cmdlet dans Exchange Online, certaines propriétés de recherche de boîte aux lettres ne sont pas renvoyées si vous ne spécifiez pas le nom d’une recherche de boîte aux lettres. Ces propriétés sont les suivantes :

  • SourceMailboxes

  • Sources

  • SearchQuery

  • ResultsLink

  • PreviewResultsLink

  • Errors

Pour afficher ces propriétés, vous devez fournir le nom d’une recherche de boîte aux lettres.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

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.

ShowDeletionInProgressSearches

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: