Get-MessageTrackingLog

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-08-20

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

Syntaxe

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>]

Description détaillée

Un journal de suivi des messages unique existe sur chaque ordinateur sur lequel le rôle serveur de transport Hub, serveur de boîtes aux lettes ou serveur de transport Edge est installé. 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 au fur et à mesure de son cheminement sur un serveur individuel.

Pour exécuter la cmdlet Get-MessageTrackingLog, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur Affichage seul d'Exchange.

Pour exécuter la cmdlet Get-MessageTrackingLog sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController.

End

Facultatif

System.DateTime

Ce paramètre renvoie des entrées de journal de suivi des messages jusqu'à la date et l'heure de End spécifiées (non comprises), en utilisant le format régional de l'ordinateur sur lequel la cmdlet est exécutée.

EventId

Facultatif

System.String

Ce paramètre retourne des entrées de journal de suivi des messages avec les catégories possibles d'événements suivantes : BadMail, Defer Deliver, DSN, Expand, Fail, PoisonMessage, Receive, Redirect, Resolve, Send, Submit et Transfer.

InternalMessageId

Facultatif

System.String

Ce paramètre retourne des entrées de journal de suivi des messages ayant la valeur InternalMessagID. InternalMessageID est un identificateur de message attribué par le serveur Exchange 2007 qui traite actuellement le message.

La valeur de InternalMessageID d'un message spécifique diffère dans le journal de suivi des messages de chaque serveur Exchange 2007 impliqué dans la remise du message.

MessageId

Facultatif

System.String

Ce paramètre renvoie des entrées de journal de suivi des messages avec le champ d'en-tête Message-ID spécifié. Si le champ d'en-tête Message-ID: est vide ou n'existe pas, une valeur arbitraire est attribuée. Cette valeur est constante pendant toute la durée de vie du message.

MessageSubject

Facultatif

System.String

Ce paramètre renvoie des entrées de journal de suivi des messages avec la valeur spécifiée du champ d'en-tête Subject: dans le message. Par défaut, les objets de message ne sont pas stockés dans les journaux de suivi des messages. Pour désactiver la journalisation des objets de message, utilisez la commande suivante :

Set-TransportServer <Identity> -MessageTrackingLogSubjectLoggingEnabled $false

Recipients

Facultatif

System.String[]

Ce paramètre retourne toutes les entrées de journal de suivi des messages avec les adresses de messagerie SMTP (Simple Mail Transfer Protocol) du destinataire spécifié. Plusieurs destinataires individuels inclus dans un message unique sont journalisés à l'aide d'une entrée unique dans le journal de suivi des messages. Les destinataires de groupe de distribution non étendu sont consignés en utilisant l'adresse de messagerie SMTP du groupe de distribution. Vous pouvez spécifier plusieurs valeurs de destinataire en utilisant des virgules comme délimiteurs.

Reference

Facultatif

System.String

Ce paramètre retourne des entrées de journal de suivi des messages avec la valeur spécifiée dans le champ Reference.

Le champ Reference contient des informations supplémentaires pour des types spécifiques d'EventID :

  • Send   Le champ Reference contient l'Internet-Message-Id de tous les messages de notification d'état de remise.

  • Transfer   Le champ Reference contient l'Internal-Message-Id du message en cours de transfert.

  • DSN   Le champ Reference contient l'Internet-Message-Id du message ayant déclenché la notification d'état de remise.

Pour tous les autres types d'EventID, le champ Reference est vide.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Ce paramètre spécifie le nombre maximal d'entrées de journal de suivi des messages à afficher. Par défaut, un nombre maximal de 1 000 entrées peuvent s'afficher. Pour afficher toutes les entrées, utilisez la valeur Unlimited.

Sender

Facultatif

System.String

Ce paramètre retourne des entrées de journal de suivi des messages avec les adresses de messagerie SMTP de l'expéditeur spécifié.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre spécifie le serveur Exchange 2007 contenant les journaux de suivi des messages dans lesquels rechercher. Le paramètre Server peut prendre l'une des valeurs suivantes pour le serveur cible :

  • Name

  • nom de domaine complet (FQDN)

  • Nom unique

  • Nom unique Exchange hérité

  • GUID

Start

Facultatif

System.DateTime

Ce paramètre retourne des entrées de journal de suivi des messages en commençant par la date et l'heure de Start spécifiées, en utilisant le format régional de l'ordinateur sur lequel la cmdlet est exécutée.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple décrit l'utilisation de la cmdlet Get-MessageTrackingLog pour extraire des entrées de journal de suivi des messages créées entre le 13/03/06 à 9:00 et le 15/03/06 à 17:00 avec la valeur de Sender tbremer@contoso.com.

Notes

Le format de date utilisé dans cet exemple est Anglais (É.U.). Utilisez le format de date configuré sur votre ordinateur Exchange Server 2007. La date que vous spécifiez est automatiquement convertie au format UTC (temps universel coordonné) utilisé au niveau interne par Exchange 2007 pour stocker des entrées dans les journaux de suivi des messages.

Le deuxième exemple montre comment canaliser la sortie vers la cmdlet Get-MessageTrackingLog vers la cmdlet Format-List pour afficher les informations supplémentaires disponibles dans le journal de suivi des messages.

Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.

Pour plus d'informations sur l'utilisation de la sortie d'une commande, consultez la rubrique Utilisation de la sortie d'une commande.

Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com"
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com" | Format-List