Get-MessageTrace

 

S’applique à :Exchange Online, Exchange Online Protection

Dernière rubrique modifiée :2016-10-10

Cette cmdlet est disponible uniquement dans le service en nuage.

Utilisez la cmdlet Get-MessageTrace pour suivre les messages lors de leur transmission à l‘organisation en nuage.

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

Get-MessageTrace [-EndDate <DateTime>] [-Expression <Expression>] [-FromIP <String>] [-MessageId <MultiValuedProperty>] [-MessageTraceId <Guid>] [-Page <Int32>] [-PageSize <Int32>] [-ProbeTag <String>] [-RecipientAddress <MultiValuedProperty>] [-SenderAddress <MultiValuedProperty>] [-StartDate <DateTime>] [-Status <MultiValuedProperty>] [-ToIP <String>]

Cet exemple récupère les informations de suivi des messages envoyés par john@contoso.com entre le samedi 13 juin 2015 et le lundi 15 juin 2015.

Get-MessageTrace -SenderAddress john@contoso.com -StartDate 06/13/2015 -EndDate 06/15/2015

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 l'entrée « Afficher les rapports » dans la rubrique Autorisations des fonctionnalités dans Exchange Online.

 

Paramètre Obligatoire Type Description

EndDate

Facultatif

System.DateTime

Le paramètre EndDate indique la fin de la plage de dates définies.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Expression

Facultatif

System.Linq.Expressions.Expression

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

FromIP

Facultatif

System.String

Le paramètre FromIP filtre les résultats par adresse IP source. Pour les messages entrants, la valeur de FromIP est l'adresse IP publique du serveur de courrier SMTP qui a envoyé le message. Pour les messages sortants d'Exchange Online, la valeur est vide.

MessageId

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

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 ID complète du message. Avec des chevrons, éventuellement.

MessageTraceId

Facultatif

System.Guid

Le paramètre MessageTraceId peut être utilisé avec l’adresse du destinataire pour identifier distinctement la trace des messages et obtenir davantage de détails. L’ID d’une trace de message est créée chaque fois que le système traite un message.

Page

Facultatif

System.Int32

Le paramètre Page indique le numéro de page des résultats que vous voulez afficher. L’entrée valide pour ce paramètre est un entier entre 1 et 1 000. La valeur par défaut est 1.

PageSize

Facultatif

System.Int32

Le paramètre PageSize indique le nombre maximal d’entrées par page. La valeur valide pour ce paramètre est un entier compris entre 1 et 5 000. Par défaut, la valeur 1 000 s’applique.

ProbeTag

Facultatif

System.String

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

RecipientAddress

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre RecipientAddress permet de filtrer les résultats par adresse de messagerie du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Vous pouvez utiliser des caractères génériques avec le format *@contoso.com, user@* ou *@*. Toutefois, si vous employez une valeur contenant des caractères génériques, vous ne pouvez pas indiquer d’autres valeurs.

SenderAddress

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre SenderAddress permet de filtrer les résultats par adresse de messagerie de l’expéditeur. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Vous pouvez utiliser des caractères génériques avec le format *@contoso.com, user@* ou *@*. Toutefois, si vous employez une valeur contenant des caractères génériques, vous ne pouvez pas indiquer d’autres valeurs.

StartDate

Facultatif

System.DateTime

Le paramètre StartDate indique le début de la plage de dates définies.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Status

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre Status filtre les résultats par l‘état de remise du message. Les valeurs valides pour ce paramètre sont les suivantes :

  • None : le message ne comporte aucun état de remise car il a été rejeté ou redirigé vers un autre destinataire.

  • Failed : une tentative de remise du message a été effectuée et a échoué, ou le message a été filtré comme courrier indésirable ou programme malveillant, voire par les règles de transport.

  • Pending : la remise du message est en cours ou a été différée et une nouvelle tentative est en cours.

  • Delivered : le message a été remis à sa destination.

  • Expanded : aucune remise du message n'a été effectuée car ce dernier a été transmis au groupe de destination, et l'appartenance de ce dernier a été développée.

ToIP

Facultatif

System.String

Le paramètre ToIP filtre les résultats par adresse IP de destination. Pour les messages sortants, la valeur de ToIP est l'adresse IP publique dans l'enregistrement MX résolu du domaine de destination. Pour les messages entrants à Exchange Online, la valeur est vide.

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: