Partager via


Search-MessageTrackingReport

Cette applet de commande est fonctionnelle uniquement dans Exchange local.

La cmdlet Search-MessageTrackingReport permet de rechercher le rapport de suivi de messages unique basé sur les critères de recherche fournis. Vous pouvez ensuite transmettre l'ID du rapport de suivi de messages à la cmdlet Get-MessageTrackingReport pour obtenir des informations complètes sur le suivi des messages. Pour plus d'informations, voir Get-MessageTrackingReport. Les cmdlets de rapport de suivi de messages sont utilisées par la fonctionnalité de rapports de remise.

Dans Exchange Online, les rapports de remise ont été remplacés par le suivi des messages (applets de commande Get-MessageTrace et Get-MessageTraceDetail).

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

Syntax

Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      -Sender <SmtpAddress>
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]
Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      [-Recipients <SmtpAddress[]>]
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]

Description

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.

Exemples

Exemple 1

Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

Cet exemple recherche les messages envoyés d'un utilisateur à un autre dans le rapport de suivi des messages. Cet exemple retourne le rapport de suivi des messages pour un message envoyé par David Jones à Wendy Richardson.

Exemple 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -BypassDelegateChecking -DoNotResolve

Cet exemple recherche dans le rapport de suivi des messages le scénario suivant : L’utilisateur Cigdem Akin s’attendait à recevoir un e-mail de joe@contoso.com qui n’est jamais arrivé. Elle a contacté le service technique, qui a besoin de générer le rapport de suivi de message de la part de Cigdem et n'a pas besoin de voir les noms complets.

Cet exemple renvoie les rapports de suivi des messages que le support technique peut analyser pour résoudre le problème.

Paramètres

-BypassDelegateChecking

Le commutateur BypassDelegateChecking permet au personnel et aux administrateurs du support technique de suivre des messages pour n’importe quel utilisateur. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Par défaut, les utilisateurs peuvent uniquement suivre les messages qu’ils envoient ou reçoivent dans leur propre boîte aux lettres.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotResolve

Le commutateur DoNotResolve indique si la résolution d’adresses e-mail en noms d’affichage doit être évitée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

L’utilisation de ce commutateur permet d’améliorer les performances, mais l’absence de noms d’affichage peut rendre difficile l’interprétation des résultats.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Le paramètre Identity cible la recherche sur la boîte aux lettres indiquée. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Domaine\Nom d’utilisateur
  • Adresse e-mail
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Lorsque vous utilisez ce paramètre sans le paramètre Sender, la boîte aux lettres spécifiée est l’expéditeur de message utilisé dans la recherche. Vous pouvez spécifier les destinataires à l’aide du paramètre Recipients.

Lorsque vous utilisez ce paramètre avec le paramètre Sender, la boîte aux lettres indiquée est le destinataire du message qui est utilisé dans la recherche.

Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MessageEntryId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MessageId

Le paramètre MessageId permet de filtrer les résultats en tenant compte de l’en-tête Message-ID dans un message. Cette valeur est également appelée ID client. Le format du paramètre Message-ID est fonction du serveur de messagerie. La valeur doit être unique pour chaque message. Toutefois, les serveurs ne sont pas tous en mesure de créer des valeurs Message-ID identiques. Veillez à inclure la chaîne d’ID de message complète (qui peut inclure des crochets) et à placer la valeur entre guillemets (par exemple, «d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com »).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Recipients

Le paramètre Recipients filtre les résultats en fonction de l’adresse e-mail des destinataires spécifiés. Vous pouvez spécifier plusieurs adresses e-mail séparées par des virgules.

Vous ne pouvez pas utiliser ce paramètre avec le paramètre Sender.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Sender

Le paramètre Sender spécifie l’adresse e-mail de l’expéditeur du message pour les messages qui sont envoyés à la boîte aux lettres spécifiée par le paramètre Identity.

Vous devez utiliser ce paramètre avec le paramètre Identity.

Type:SmtpAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Subject

Le paramètre Subject recherche les messages ayant la valeur de champ Subject indiquée. Si la valeur contient des espaces, placez-la entre guillemets.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TraceLevel

Le paramètre TraceLevel spécifie les détails à inclure dans les résultats. Les valeurs valides sont les suivantes :

  • Faible : des données supplémentaires minimales sont retournées, y compris les serveurs auxquels l’accès a été fait, le minutage, le nombre de résultats de recherche de suivi des messages et les informations d’erreur éventuelles.
  • Moyenne : en plus de toutes les données retournées pour le paramètre Faible, les résultats de recherche de suivi des messages réels sont également retournés.
  • Élevé : les données de diagnostic complètes sont retournées.

Ce paramètre n’est nécessaire que pour la résolution des problèmes de suivi des messages.

Type:TraceLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entrées

Input types

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.

Sorties

Output types

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.