Get-MessageTrackingReport

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2017-07-27

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

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.

noteRemarque :
Bien que cette cmdlet soit disponible dans Exchange Online, elle ne renvoie pas de résultats précis.

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

Get-MessageTrackingReport -Identity <MessageTrackingReportId> [-BypassDelegateChecking <SwitchParameter>] [-DetailLevel <Basic | Verbose>] [-DomainController <Fqdn>] [-DoNotResolve <SwitchParameter>] [-RecipientPathFilter <SmtpAddress>] [-Recipients <String[]>] [-ReportTemplate <Summary | RecipientPath>] [-ResultSize <Unlimited>] [-Status <Unsuccessful | Pending | Delivered | Transferred | Read>] [-TraceLevel <Low | Medium | High>]

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.

$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 de messages pour le scénario suivant : L'utilisateur Cigdem Akin a attendu un message électronique 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 les données de suivi pour les rapports de suivi d’un message spécifique et renvoie des informations de dépannage détaillées pour le chemin du destinataire spécifique.

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 }

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 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 «Suivi de messages» dans la rubrique Autorisations de flux de messagerie.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Management.Tracking.MessageTrackingReportId

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.

BypassDelegateChecking

Facultatif

System.Management.Automation.SwitchParameter

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.

DetailLevel

Facultatif

Microsoft.Exchange.InfoWorker.Common.MessageTracking.MessageTrackingDetailLevel

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

  • Basic   Des informations simples sur le rapport de remise sont renvoyées, ce qui est le plus approprié pour les utilisateurs.

  • Verbose   Des informations complètes sur le rapport sont renvoyées, y compris les noms de serveur et les informations sur la topologie physique.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

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.

DoNotResolve

Facultatif

System.Management.Automation.SwitchParameter

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.

RecipientPathFilter

Facultatif

Microsoft.Exchange.Data.SmtpAddress

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

Recipients

Facultatif

System.String[]

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.

ReportTemplate

Facultatif

Microsoft.Exchange.InfoWorker.Common.MessageTracking.ReportTemplate

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

  • RecipientPath   Renvoie un rapport de suivi détaillé pour un destinataire du message. Vous spécifiez le destinataire à l’aide du paramètre RecipientPathFilter.

  • Summary   Renvoie un résumé pour tous les destinataires du message. Vous spécifiez les destinataires à l’aide du paramètre Recipients.

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.

Status

Facultatif

Microsoft.Exchange.Management.Tracking._DeliveryStatus

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 :

  • Delivered

  • Read

  • Pending

  • Transferred

  • Unsuccessful

TraceLevel

Facultatif

Microsoft.Exchange.Management.Tracking.TraceLevel

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

  • Low   Les données supplémentaires renvoyées sont minimes et englobent notamment les serveurs consultés, le temps, le nombre de résultats de recherche dans le cadre du suivi des messages et toutes les informations concernant les erreurs survenues.

  • Medium   Outre l’ensemble des données renvoyées pour le paramètre Low, les résultats de recherche réels du suivi des messages sont également renvoyés.

  • High   Des données de diagnostic complètes sont renvoyées.

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

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: