Get-MessageTrackingLog
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.
Syntax
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 cette rubrique répertorie tous les paramètres de cette cmdlet, 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 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/2018 09:00:00" -End "03/15/2018 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 du 13 mars 2018 de 9h00 au 15 mars 2018 à 17h00 par l’expéditeur john@contoso.com.
Paramètres
-DomainController
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-End
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 jj/mm/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".
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EventId
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalMessageId
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageId
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 »).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageSubject
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-NetworkMessageId
Le paramètre NetworkMessageId filtre les entrées de journaux de suivi de messages selon la valeur du champ InternalMessageId. Ce champ comporte une valeur unique d’ID de message qui persiste dans les copies du message éventuellement créées suite à une bifurcation ou à une expansion du groupe de distribution. 1341ac7b13fb42ab4d4408cf7f55890f est un exemple de valeur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Recipients
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 adresses électroniques de destinataires séparées par des virgules.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Reference
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
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.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Sender
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
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é
Type: | ServerIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Source
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Start
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 jj/mm/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".
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransportTrafficType
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
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.