Get-MessageTraceV2
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande Get-MessageTraceV2 pour suivre les messages à mesure qu’ils passent dans le organization cloud.
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-MessageTraceV2
[[-EndDate] <System.DateTime>]
[[-FromIP] <String>]
[[-MessageId] <MultiValuedProperty>]
[[-MessageTraceId] <System.Guid>]
[[-RecipientAddress] <MultiValuedProperty>]
[[-ResultSize] <Int32>]
[[-SenderAddress] <MultiValuedProperty>]
[[-StartDate] <System.DateTime>]
[[-StartingRecipientAddress] <String>]
[[-Status] <MultiValuedProperty>]
[[-SubjectFilterType] <String>]
[[-Subject] <String>]
[[-ToIP] <String>]
[<CommonParameters>]
Description
Vous pouvez utiliser cette applet de commande pour rechercher les données des messages des 90 derniers jours. Si vous exécutez cette applet de commande sans aucun paramètre, seules les données des dernières 48 heures sont retournées. Vous ne pouvez retourner que 10 jours de données par requête.
Par défaut, cette applet de commande retourne jusqu’à 1 000 résultats, avec un maximum de 5 000 résultats. Si vos données dépassent la taille du résultat, effectuez des requêtes en plusieurs cycles ou utilisez des intervalles StartDate et EndDate plus petits.
Les horodatages sur la sortie sont au format d’heure UTC. Cela peut être différent du format d’heure que vous avez utilisé pour les paramètres -StartDate et -EndDate.
Limite de limitation : un maximum de 100 demandes de requête sont acceptées dans une fenêtre d’exécution de 5 minutes. La limitation n’est pas appliquée automatiquement si le taux de requêtes est inférieur à 100 requêtes au cours des 5 dernières minutes
La pagination n’est pas prise en charge dans cette applet de commande. Pour interroger les données suivantes, utilisez les paramètres StartingRecipientAddress et EndDate avec les valeurs des propriétés Adresse du destinataire et Heure de réception respectivement du résultat précédent dans la requête suivante.
Meilleures pratiques :
- Utilisez le paramètre ResultSize pour ajuster la taille de vos résultats.
- Soyez aussi précis que possible. Réduisez l’écart entre StartDate et EndDate et utilisez des paramètres supplémentaires (par exemple, SenderAddress) si possible.
- Utilisez MessageTraceId si possible (requis pour les messages envoyés à plus de 1 000 destinataires).
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-MessageTraceV2 -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025
Cet exemple récupère les informations de suivi des messages pour les messages envoyés entre john@contoso.com le 13 juin 2025 et le 15 juin 2025.
Paramètres
-EndDate
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre EndDate indique la fin 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/2025 pour spécifier le 1er septembre 2025. 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 du jour, placez la valeur entre guillemets (), par exemple, « 01/09/2025 17:00 ».
Propriétés du paramètre
| Type: | System.DateTime |
| 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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-FromIP
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
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: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MessageId
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 d’ID de message complète (qui peut inclure des crochets) et à placer la valeur entre guillemets (par exemple, «d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com »).
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MessageTraceId
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre MessageTraceId filtre les résultats en fonction de la valeur d’ID de trace du message. Cette valeur GUID est générée pour chaque message traité par le système (par exemple, c20e0f7a-f06b-41df-fe33-08d9da155ac1).
La valeur MessageTraceId est également disponible dans la sortie des applets de commande suivantes :
- Get-MailDetailATPReport
- Get-MailDetailDlpPolicyReport
- Get-MailDetailEncryptionReport
- Get-MailDetailTransportRuleReport
- Get-MessageTraceDetailV2
Propriétés du paramètre
| Type: | System.Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RecipientAddress
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 5 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ResultSize
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Une valeur valide est comprise entre 1 et 5 000. La valeur par défaut est 1000.
Remarque : ce paramètre remplace le paramètre PageSize qui était disponible sur l’applet de commande Get-MessageTrace.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | 0 |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 6 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-SenderAddress
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 7 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-StartDate
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre StartDate indique le 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/2025 pour spécifier le 1er septembre 2025. 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 du jour, placez la valeur entre guillemets (), par exemple, « 01/09/2025 17:00 ».
Propriétés du paramètre
| Type: | System.DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 8 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-StartingRecipientAddress
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre StartingRecipientAddress est utilisé avec le paramètre EndDate pour interroger les données suivantes pour obtenir des résultats partiels tout en évitant la duplication. Interrogez les données suivantes en prenant les valeurs Adresse du destinataire et Heure de réception du dernier enregistrement des résultats partiels et en les utilisant comme valeurs pour les paramètres StartingRecipientAddress et EndDate respectivement dans la requête suivante.
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: | 9 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Status
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Status filtre les résultats par l‘état de remise du message. Les valeurs valides sont les suivantes :
- Delivered : le message a été remis à sa destination.
- Développé : il n’y a pas eu de remise de message, car le message a été adressé à un groupe de distribution et l’appartenance de la distribution a été étendue.
- Échec : la remise du message a été tentée et elle a échoué.
- FilteredAsSpam : le message a été marqué comme courrier indésirable.
- GettingStatus : le message attend status mise à jour.
- Pending : la remise du message est en cours ou a été différée et une nouvelle tentative est en cours.
- Mis en quarantaine : le message a été mis en quarantaine.
Vous pouvez spécifier plusieurs valeurs séparées par des virgules.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 10 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Subject
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Subject filtre les résultats en fonction de l’objet du message. Si la valeur contient des espaces, placez-la entre guillemets (").
Vous spécifiez la façon dont la valeur est évaluée dans l’objet du message à l’aide du paramètre SubjectFilterType.
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: | 11 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-SubjectFilterType
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre SubjectFilterType spécifie la façon dont la valeur du paramètre Subject est évaluée. Les valeurs valides sont les suivantes :
- Contains
- EndsWith
- StartsWith
Nous vous recommandons d’utiliser StartsWith ou EndsWith au lieu de Contains dans la mesure du possible.
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: | 12 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ToIP
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
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: | 13 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| 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.