Get-MessageTrackingReport

Cette applet de commande est fonctionnelle uniquement dans Exchange local.

La cmdlet Get-MessageTrackingReport permet de renvoyer les données du rapport de suivi d’un message spécifique. Cette cmdlet est utilisée 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

Get-MessageTrackingReport
   [-Identity] <MessageTrackingReportId>
   [-BypassDelegateChecking]
   [-DetailLevel <MessageTrackingDetailLevel>]
   [-DomainController <Fqdn>]
   [-DoNotResolve]
   [-RecipientPathFilter <SmtpAddress>]
   [-Recipients <String[]>]
   [-ReportTemplate <ReportTemplate>]
   [-ResultSize <Unlimited>]
   [-Status <DeliveryStatus>]
   [-TraceLevel <TraceLevel>]
   [<CommonParameters>]

Description

Cette cmdlet nécessite l’ID du rapport de suivi de message que vous souhaitez afficher. Par conséquent, vous devez tout d’abord utiliser la cmdlet Search-MessageTrackingReport pour rechercher l’ID du rapport de suivi d’un message spécifique, puis transmettre les résultats à cette cmdlet. Pour plus d’informations, consultez la rubrique Search-MessageTrackingReport.

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

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

Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate Summary

Cet exemple permet d’obtenir le rapport de suivi des messages envoyés par un utilisateur à un autre. Cet exemple renvoie le résumé du rapport de suivi d’un message envoyé par David Jones à Wendy Richardson.

Exemple 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object { Get-MessageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigdem@fabrikam.com" -ReportTemplate RecipientPath }

Cet exemple obtient le rapport de suivi des messages pour le scénario suivant : L’utilisateur Cigdem Akin attendait 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 recherche dans les données de suivi des messages les rapports de suivi des messages spécifiques, puis retourne des informations de dépannage détaillées pour le chemin d’accès du destinataire spécifique.

Paramètres

-BypassDelegateChecking

Le paramètre BypassDelegateChecking permet au personnel et aux administrateurs du support technique d’obtenir des rapports de suivi de message pour n’importe quel utilisateur. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Par défaut, chaque utilisateur ne peut voir que les rapports de suivi des messages qu’il envoie ou reçoit dans sa propre boîte aux lettres. Lorsque vous utilisez ce commutateur, vous pouvez afficher les rapports de suivi de message concernant les échanges de messages entre d’autres utilisateurs.

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

-DetailLevel

Le paramètre DetailLevel indique la quantité de détails à renvoyer dans les résultats. Les valeurs valides sont les suivantes :

  • De base : les informations de rapport de remise simples sont retournées, ce qui est plus approprié pour les utilisateurs.
  • Détaillé : les informations complètes du rapport sont retournées, y compris les noms de serveurs et les informations de topologie physique.
Type:MessageTrackingDetailLevel
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

-DomainController

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 spécifie l’ID du rapport de suivi de message que vous souhaitez afficher.

Vous devez exécuter la cmdlet Search-MessageTrackingReport pour rechercher l’ID du rapport de suivi d’un message spécifique que vous suivez, puis transmettre la valeur du champ MessageTrackingReportID à ce paramètre.

Type:MessageTrackingReportId
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

-RecipientPathFilter

Le paramètre RecipientPathFilter spécifie l’adresse e-mail du destinataire lorsque vous utilisez le paramètre ReportTemplate avec la valeur RecipientPath.

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

-Recipients

Le paramètre Recipients spécifie les adresses e-mail des destinataires lorsque vous utilisez le paramètre ReportTemplate avec la valeur Summary. Vous pouvez spécifier plusieurs adresses e-mail séparées par des virgules.

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

-ReportTemplate

Le paramètre ReportTemplate spécifie un format prédéfini pour la sortie. Les valeurs valides sont les suivantes :

  • RecipientPath : retourne un rapport de suivi détaillé pour un destinataire du message. Vous spécifiez le destinataire à l’aide du paramètre RecipientPathFilter.
  • Résumé : retourne un résumé pour tous les destinataires du message. Vous spécifiez les destinataires à l’aide du paramètre Recipients.
Type:ReportTemplate
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

-Status

Le paramètre Status filtre les résultats en fonction des codes d’état de remise spécifiés. Les valeurs valides sont les suivantes :

  • Remis
  • Lecture
  • Pending
  • Transféré
  • Infructueuse
Type:_DeliveryStatus
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 toutes les informations d’erreur.
  • Moyenne : en plus des données retournées pour le paramètre Faible, les résultats réels de la recherche de suivi des messages 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

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.