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 sont remplacés par le suivi des messages (applets de commande Get-MessageTraceV2 et Get-MessageTraceDetailV2).
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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"
foreach ($reportId in $Temp.MessageTrackingReportId) {
Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}
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
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DetailLevel
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriétés des paramètres
| Type: | MessageTrackingDetailLevel |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 ».
Propriétés des paramètres
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DoNotResolve
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | MessageTrackingReportId |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RecipientPathFilter
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre RecipientPathFilter spécifie l’adresse e-mail du destinataire lorsque vous utilisez le paramètre ReportTemplate avec la valeur RecipientPath.
Propriétés des paramètres
| Type: | SmtpAddress |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Recipients
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ReportTemplate
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | ReportTemplate |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResultSize
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | Unlimited |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Status
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- Lire
- Pending
- Transféré
- Infructueux
Propriétés des paramètres
| Type: | _DeliveryStatus |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TraceLevel
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 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.
Propriétés des paramètres
| Type: | TraceLevel |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.