Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Search-Mailbox

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-09-13

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 Search-Mailbox permet de rechercher une boîte aux lettres et copier les résultats dans une boîte aux lettres cible spécifiée, de supprimer des messages de la boîte aux lettres source, ou bien les deux.

Search-Mailbox [-DeleteContent <SwitchParameter>] <COMMON PARAMETERS>

Search-Mailbox -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-DeleteContent <SwitchParameter>] [-LogLevel <Suppress | Basic | Full>] [-LogOnly <SwitchParameter>] <COMMON PARAMETERS>

Search-Mailbox -EstimateResultOnly <SwitchParameter> <COMMON PARAMETERS>

COMMON PARAMETERS: -Identity <MailboxOrMailUserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>] [-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>] [-SearchDumpster <SwitchParameter>] [-SearchDumpsterOnly <SwitchParameter>] [-SearchQuery <String>] [-WhatIf [<SwitchParameter>]]

Cet exemple effectue une recherche dans la boîte aux lettres de Joe Healy et copie les résultats de la recherche dans le dossier JoeHealy ProjectHamilton de DiscoveryMailbox.

Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full

Cet exemple recherche dans la boîte aux lettres d’April Stewart des messages dont l’objet contient l’expression « Your bank statement » (Votre relevé de compte) et consigne le résultat dans le dossier SearchAndDeleteLog de la boîte aux lettres de l’administrateur. Les messages ne sont pas copiés dans la boîte aux lettres cible.

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full

Cet exemple recherche dans la boîte aux lettres d’April Stewart des messages dont l’objet contient l’expression « Your bank statement » et supprime les messages de la boîte aux lettres source. Vous devez disposer du rôle de gestion Importation/Exportation de boîte aux lettres pour utiliser le commutateur DeleteContent.

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent

Cet exemple effectue une recherche dans toutes les boîtes aux lettres au sein de votre organisation et cherche des messages contenant les mots « election » (élection), « candidate » (candidat) ou « vote ». Les résultats de la recherche sont copiés dans la boîte aux lettres « Discovery Search Mailbox », dans le dossier « AllMailboxes-Election ».

Get-Mailbox | Search-Mailbox -SearchQuery 'election OR candidate OR vote' -TargetMailbox "Discovery Search Mailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full

La cmdlet Search-Mailbox permet de rechercher des messages dans une boîte aux lettres spécifique et de réaliser les tâches suivantes :

  • Copier des messages dans une boîte aux lettres cible spécifiée.

  • Supprimer des messages de la boîte aux lettres source. Vous devez disposer du rôle de gestion Importation/Exportation de boîte aux lettres pour supprimer des messages.

  • Copier des messages de la boîte aux lettres source et les supprimer de la boîte aux lettres cible.

  • Procéder à une récupération d’élément unique pour récupérer des éléments à partir du dossier Éléments récupérables d’un utilisateur.

  • Nettoyer le dossier Éléments récupérables d’une boîte aux lettres dès qu’il a atteint le quota inconditionnel fixé pour ce dossier.

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 les entrées « Découverte électronique locale » et « Suppression du contenu de la boîte aux lettres » dans la rubrique Stratégie de messagerie et autorisations de conformité dans Exchange 2016.

 

Paramètre Obligatoire Type Description

EstimateResultOnly

Obligatoire

System.Management.Automation.SwitchParameter

Le commutateur EstimateResultOnly indique que vous obtiendrez seulement une estimation du nombre total et de la taille des messages renvoyés par la recherche. Les messages ne sont pas copiés dans la boîte aux lettres cible. Vous ne pouvez pas utiliser ce commutateur avec le paramètre TargetMailbox.

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter

Le paramètre Identity spécifie le nom de la boîte aux lettres à rechercher.

Ce paramètre accepte les valeurs suivantes :

  • Alias

    Exemple : JPhillips

  • Canonical DN

    Exemple : Atlanta.Corp.Contoso.Com/Users/JPhilips

  • Display Name

    Exemple : Jeff Philips

  • Distinguished Name (DN)

    Exemple : CN = JPhillips, CN = Users, DC = Atlanta, DC = Corp, DC = contoso, DC = com

  • Domain\Account

    Exemple : Atlanta\JPhillips

  • GUID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2

  • Immutable ID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com

  • Legacy Exchange DN

    Exemple : /o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhilips

  • SMTP Address

    Exemple : Jeff.Phillips@contoso.com

  • User Principal Name

    Exemple : JPhillips@contoso.com

TargetFolder

Obligatoire

System.String

Le paramètre TargetFolder spécifie le nom d’un dossier de la boîte aux lettres cible dans lequel les résultats de la recherche sont enregistrés. Le dossier est créé dans la boîte aux lettres cible dès exécution.

TargetMailbox

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre TargetMailbox spécifie l’identité de la boîte aux lettres de destination dans laquelle les résultats de recherche sont copiés. Vous pouvez utiliser les valeurs suivantes :

  • Alias

  • Nom complet

  • Domaine\Compte

  • Adresse SMTP

  • DN

  • GUID d’objet

  • UPN

  • LegacyExchangeDN

Lorsque vous spécifiez une valeur pour le paramètre TargetMailbox, vous devez utiliser le paramètre TargetFolder. Vous ne pouvez pas utiliser ce paramètre avec le commutateur EstimateResultOnly.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

DeleteContent

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur DeleteContent spécifie que les messages renvoyés par la recherche sont définitivement supprimés dans la boîte aux lettres source. Lorsqu’ils sont utilisés avec le paramètre TargetMailbox, les messages sont copiés dans la boîte aux lettres cible et supprimés de la boîte aux lettres source. Si vous définissez le niveau d’enregistrement de la recherche sur Basic ou Full, vous devez spécifier une boîte aux lettres cible et un dossier cible dans lequel stocker le journal. Pour supprimer les messages de la boîte aux lettres source sans les copier dans la boîte aux lettres cible, ne spécifiez pas les paramètres TargetMailbox, TargetFolder et LogLevel.

importantImportant :
Vous devez disposer du rôle de gestion Importation/Exportation de boîte aux lettres pour utiliser ce commutateur. Par défaut, ce rôle n’est affecté à aucun groupe de rôles. Généralement, vous attribuez un rôle à un groupe de rôles intégrés ou personnalisés. Vous pouvez également affecter un rôle à un utilisateur ou à un groupe de sécurité universel.
Avant d’utiliser le commutateur DeleteContent pour supprimer du contenu, nous vous conseillons de tester les paramètres de recherche au moyen du paramètre LogOnly, comme le montre l’exemple 2.

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.

DoNotIncludeArchive

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur DoNotIncludeArchive Spécifie que la boîte aux lettres de l’utilisateur archive ne doivent pas être inclus dans la recherche. Vous n’avez pas besoin de spécifier une valeur pour le commutateur. Par défaut, la boîte aux lettres d’archive est toujours recherché.

Si l’extension automatique d’archivage est activé pour une boîte aux lettres Exchange Online, seule la boîte aux lettres de l’utilisateur principal d’archive est recherchée. Boîtes aux lettres d’archive auxiliaire ne sont pas inclus dans la recherche.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force remplace l’invite de confirmation qui s’affiche lorsque vous utilisez le commutateur DeleteContent pour supprimer définitivement des messages.

IncludeUnsearchableItems

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeUnsearchableItems spécifie s’il faut inclure les éléments qui n’ont pu être indexés par la recherche Exchange. Lorsqu’il est défini sur $true, le commutateur IncludeUnsearchableItems indique que les éléments qui n’ont pu être indexés par la recherche Exchange doivent être inclus dans les résultats de la recherche.

LogLevel

Facultatif

Microsoft.Exchange.Data.Storage.Infoworker.MailboxSearch.LoggingLevel

Le paramètre LogLevel spécifie le niveau de journalisation de la recherche. Il peut prendre l’une des valeurs suivantes :

  • Suppress   Aucun journal n’est conservé.

  • Basic   Des informations de base concernant la requête et la personne l’ayant exécutée sont conservées.

  • Full   En complément des informations conservées par le niveau de journal Basic, le niveau de journal Full ajoute la liste complète des résultats de recherche.

Le niveau par défaut du journal est Basic.

LogOnly

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur LogOnly spécifie qu’une recherche est à effectuer et qu’un journal seulement est à générer. Les messages renvoyés par la recherche ne sont pas copiés dans la boîte aux lettres cible. Le niveau d’enregistrement est précisé à l’aide du paramètre LogLevel.

SearchDumpster

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre SearchDumpster spécifie s’il faut rechercher le dossier Éléments récupérables, dans lequel sont conservés les éléments supprimés du dossier Éléments supprimés ou les éléments définitivement supprimés jusqu’à ce qu’il soient purgés de la base de données de boîte aux lettres. Par défaut, le dossier Éléments récupérables fait systématiquement l’objet d’une recherche. Pour exclure le dossier de la recherche, définissez le commutateur SearchDumpster sur $false (par exemple, -SearchDumpster:$false)

SearchDumpsterOnly

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur SearchDumpsterOnly précis que seul le dossier Éléments récupérables de la boîte aux lettres spécifiée est à rechercher. Vous pouvez également utiliser ce commutateur avec le commutateur DeleteContent pour supprimer des messages du dossier Éléments récupérables et réduire la taille du dossier.

SearchQuery

Facultatif

System.String

Le paramètre SearchQuery spécifie une chaîne de recherche ou une requête formatée en utilisant la syntaxe KQL (Keyword Query Language). Pour plus d'informations sur la syntaxe KQL, consultez la rubrique Référence sur la syntaxe Keyword Query Language.

Si ce paramètre est vide, tous les messages sont renvoyés.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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: