Partager via

Get-MessageTrackingLog

Module:
Exchange PowerShell

La cmdlet est disponible uniquement dans Exchange en local.

La cmdlet Get-MessageTrackingLog permet d’effectuer une recherche d'informations de remise de message stockées dans le journal de suivi des messages.

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-MessageTrackingLog
    [-DomainController <Fqdn>]
    [-End <DateTime>]
    [-EventId <String>]
    [-InternalMessageId <String>]
    [-MessageId <String>]
    [-MessageSubject <String>]
    [-Recipients <String[]>]
    [-Reference <String>]
    [-ResultSize <Unlimited>]
    [-Sender <String>]
    [-Server <ServerIdParameter>]
    [-Start <DateTime>]
    [-NetworkMessageId <String>]
    [-Source <String>]
    [-TransportTrafficType <String>]
    [<CommonParameters>]

Description

Un journal de suivi des messages unique existe pour le service de transport sur un serveur de boîtes aux lettres, pour le service de transport de boîtes aux lettres sur un serveur de boîtes aux lettres et sur un serveur de transport Edge. Le journal de suivi des messages est un fichier CSV (valeurs séparées par des virgules) contenant des informations détaillées sur l’historique de chaque message électronique durant son cheminement dans un serveur Exchange.

Les noms de champ affichés dans les résultats de l’exécution de la cmdlet Get-MessageTrackingLog sont similaires aux noms de champs actuels utilisés dans les journaux de suivi des messages. Les différences sont les suivantes :

  • Les tirets sont supprimés des noms de champ. Par exemple, internal-message-id est affiché sous la forme InternalMessageId.
  • Le champ date-time est affiché sous la forme Timestamp.
  • Le champ recipient-address est affiché sous la forme Recipients.
  • Le champ sender-address est affiché sous la forme Sender.

Pour plus d’informations sur les fichiers journaux de suivi des messages, consultez Suivi des messages.

Vous pouvez écrire les résultats dans un fichier en pipant la sortie vers ConvertTo-Html ou ConvertTo-Csv et en ajoutant > <filename> à la commande . Par exemple : Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html".

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

Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2024 09:00:00" -End "03/15/2024 17:00:00" -Sender "john@contoso.com"

Cet exemple recherche dans les journaux de suivi des messages sur le serveur de boîtes aux lettres nommé Mailbox01 des informations sur tous les messages envoyés entre le 13 mars 2024, 9:00 et le 15 mars 2024, 17:00 par l’expéditeur john@contoso.com.

Exemple 2

Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2024 09:00:00" -Recipients @("john@contoso.com","alice@contoso.com")

Cet exemple recherche dans les journaux de suivi des messages sur le serveur de boîtes aux lettres nommé Mailbox01 des informations sur tous les messages envoyés du 13 mars 2024 à 09:00 à aujourd’hui pour les destinataires john@contoso.com et/ou alice@contoso.com.

Paramètres

-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 ».

Les serveurs de transport Edge ne prennent pas en charge le paramètre DomainController. Un serveur de transport Edge utilise l’instance locale des services AD LDS (Active Directory Lightweight Directory Services) pour lire et écrire des données.

Propriétés du paramètre

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

-End

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre End indique la date et l’heure de fin de la plage de dates définies. Les informations de remise de message sont envoyées jusqu’à la date et l’heure spécifiées non incluses.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Propriétés du paramètre

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

-EventId

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre EventId filtre les entrées de journaux de suivi de messages selon la valeur du champ EventId. La valeur EventId classifie chaque événement de message. DSN, Defer, Deliver, Send, ou Receive sont des exemples de valeurs.

Propriétés du paramètre

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

-InternalMessageId

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre InternalMessageId filtre les entrées de journaux de suivi de messages selon la valeur du champ InternalMessageId. Le InternalMessageId est un identifiant de message affecté par le serveur Exchange qui traite actuellement le message.

La valeur internal-message-id pour un message spécifique est différente dans le journal de suivi des messages de chaque serveur Exchange intervenant dans la remise du message.

Propriétés du paramètre

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

-MessageId

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre MessageId filtre les entrées de journaux de suivi de messages selon la valeur du champ MessageId. La valeur de MessageId correspond à la valeur du champ d’en-tête de Message-Id: dans le message. Si le champ d’en-tête Message-ID est vide ou n’existe pas, une valeur arbitraire est attribuée. Veillez à inclure la chaîne MessageId complète (qui peut inclure des crochets) et à placer la valeur entre guillemets (par exemple, «d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com »).

Propriétés du paramètre

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

-MessageSubject

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre MessageSubject filtre les entrées de journaux de suivi de messages selon la valeur du sujet du message. La valeur du paramètre MessageSubject prend automatiquement en charge les correspondances partielles sans utilisation de caractères génériques ou de caractères spéciaux. Par exemple, si vous spécifiez la valeur sea en tant que MessageSubject, les résultats incluent les messages dont le sujet contient Seattle. Par défaut, les objets de message ne sont pas stockés dans les journaux de suivi des messages.

Propriétés du paramètre

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

-NetworkMessageId

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre NetworkMessageId filtre les entrées de journaux de suivi de messages selon la valeur du champ InternalMessageId. Ce champ contient une valeur d’ID de message unique qui persiste entre les copies du message qui peuvent être créées en raison de la bifurcation ou de l’expansion du groupe de distribution. 1341ac7b13fb42ab4d4408cf7f55890f est un exemple de valeur.

Propriétés du paramètre

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

-Recipients

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Recipients filtre les entrées de journaux de suivi de messages selon l’adresse de messagerie électronique SMTP des destinataires des messages. Plusieurs destinataires dans un message unique sont consignés dans une seule entrée du journal de suivi des messages. Les destinataires de groupes de distribution non étendus sont consignés selon l’adresse de messagerie électronique SMTP. Vous pouvez spécifier plusieurs destinataires à l’aide d’un tableau d’adresses e-mail.

Propriétés du paramètre

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

-Reference

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Reference filtre les entrées de journaux de suivi de messages selon la valeur du champ Reference. Le champ Reference contient des informations supplémentaires pour des types spécifiques d’événements. Par exemple, la valeur du champ Reference pour une entrée de suivi de messages DSN contient la valeur InternalMessageId du message ayant causé la DSN. La valeur de Reference est vide pour la plupart des types d’événements.

Propriétés du paramètre

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

-ResultSize

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 du paramètre

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

-Sender

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Sender filtre les entrées de journaux de suivi de messages selon l’adresse de messagerie électronique SMTP de l’expéditeur.

Propriétés du paramètre

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

-Server

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Server définit le serveur Exchange sur lequel vous souhaitez exécuter cette commande. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • FQDN
  • Nom unique
  • DN Exchange hérité

DN Exchange hérité

Propriétés du paramètre

Type:ServerIdParameter
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:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Source

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Source filtre les entrées de journaux de suivi de messages selon la valeur du champ Source. Ces valeurs indiquent le composant de transport responsable de l’événement de suivi de message. Pour plus d’informations, consultez la rubrique Source values in the message tracking log.

Propriétés du paramètre

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

-Start

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Start indique la date et l’heure de début de la plage de dates définies.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Propriétés du paramètre

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

-TransportTrafficType

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre TransportTrafficType filtre les entrées de journaux de suivi de messages selon la valeur du champ TransportTrafficType. Toutefois, ce champ n’est pas intéressant pour les organisations Exchange locales.

Propriétés du paramètre

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

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.