/
/

Comment obtenir des rapports de suivi des messages Microsoft 365 avec PowerShell

par Team Ninja
How to Get Microsoft 365 Message Tracing Reports Using PowerShell blog banner image

Points clés

  • Utilisez PowerShell dans Microsoft 365 pour générer des suivis de messages Exchange Online et connaître le statut de distribution, les retards et les échecs.
  • Exécutez Get-MessageTraceV2 pour les suivis en direct sur les 10 derniers jours et Get-MessageTraceDetailV2 pour un diagnostic de distribution saut par saut.
  • Lancez Start-HistoricalSearch pour les collectes de données sur de longues périodes ou à grande échelle et créez des exports CSV prêts pour l’audit couvrant jusqu’à 90 jours d’activité de messagerie.
  • Normalisez et enrichissez les données de suivi avec des champs calculés (TimeSpanMinutes, DeliveryOutcome, par exemple) afin de simplifier l’analyse et les contrôles de conformité.
  • Automatisez le suivi des messages grâce à l’authentification sécurisée en mode application uniquement, à des tâches PowerShell planifiées et à une gestion des erreurs robuste pour une exécution non interactive.
  • Stockez et documentez les résultats de vos suivis de façon systématique pour appuyer les audits, les enquêtes et une visibilité continue sur la gouvernance de la messagerie.

L’outil de suivi des messages Microsoft 365 permet aux fournisseurs de services gérés (MSP) et aux administrateurs IT d’analyser et de surveiller la distribution des e-mails dans Exchange Online, avec précision et de façon reproductible. Associé à l’automatisation PowerShell et à différentes cmdlets, le suivi permet aux équipes de répondre rapidement aux questions de distribution, de produire des rapports prêts pour l’audit et d’étendre leurs analyses à plusieurs tenants. Voici un workflow structuré qui garantit la visibilité opérationnelle et la conformité.

Générer des rapports de suivi des messages Microsoft 365 avec PowerShell

Le suivi des messages dans Microsoft 365 retrace le parcours d’un e-mail dans Exchange Online et explique pourquoi il a été distribué, différé ou rejeté. C’est donc un outil indispensable pour la visibilité et la gouvernance du flux de messagerie. PowerShell propose plusieurs méthodes souples pour générer ces rapports et permet aux administrateurs de collecter des données récentes comme historiques avec précision. Les étapes ci-dessous détaillent les cmdlets à utiliser, la manière de mettre en forme et d’enrichir les résultats, puis d’exploiter efficacement les rapports au fil des différentes phases.

📌 Prérequis :

  • Module Exchange Online PowerShell installé sur un poste de travail d’administration
  • Droits nécessaires pour exécuter le suivi des messages et la recherche historique dans le tenant
  • Stockage sécurisé des identifiants et répertoire de sortie pour les exports
  • Inscription d’application Azure facultative pour l’automatisation en mode application uniquement

Phase 1 : collecter les données

La première étape consiste à rassembler les données nécessaires à toute analyse de suivi des messages à l’aide des cmdlets PowerShell. Deux options s’offrent à vous, selon la période visée et vos besoins de reporting.

Option 1 : lancer des suivis en direct pour les messages récents

Un suivi en direct vous permet de vérifier rapidement ce qu’est devenu un message envoyé récemment (uniquement dans les 10 derniers jours) dans Microsoft 365. Vous pouvez ainsi déterminer si un message a bien été distribué, retardé ou rejeté, et visualiser le chemin exact qu’il a emprunté dans Exchange Online, sans avoir besoin d’exports volumineux.

  1. Sur un poste de travail géré, connectez-vous à Exchange Online en ouvrant une session sécurisée avec un compte d’administration disposant des droits de suivi des messages, et assurez-vous d’être connecté au bon tenant avant de lancer un suivi.
  2. Utilisez Get-MessageTraceV2 avec des filtres bornés dans le temps. Définissez une fenêtre temporelle récente et appliquez des filtres précis (expéditeur, destinataire, mot-clé dans l’objet ou statut, par exemple) afin de ne retourner que les résultats pertinents.
  3. Pour tout message nécessitant une analyse plus poussée, récupérez les détails des sauts (règles de transport appliquées, sauts de connecteur, verdicts anti-spam/anti-malware, retards, etc.) qui expliquent le résultat de la distribution, à l’aide de Get-MessageTraceDetailV2.

💡 Remarque : Microsoft a déprécié les cmdlets Get-MessageTrace et Get-MessageTraceDetail, remplacées respectivement par Get-MessageTraceV2 et Get-MessageTraceDetailV2.

  1. Enregistrez les sorties au format CSV (et éventuellement JSON) et indiquez l’identifiant du tenant, les heures de début et de fin ainsi que les paramètres de filtrage dans le nom de fichier ou les métadonnées.

Option 2 : utiliser la recherche historique pour les périodes plus longues

Si vous devez analyser le flux de messagerie au-delà de la fenêtre du suivi en direct ou rassembler de vastes jeux de données pour des audits, tournez-vous vers la recherche historique. Elle interroge le backend de Microsoft pour générer des rapports CSV plus complets sur des périodes plus longues (jusqu’à 90 jours), ce qui est idéal pour les revues de conformité et le reporting de gouvernance mensuel.

  1. Utilisez Start-HistoricalSearch pour demander un rapport sur une plage de dates définie (de plusieurs jours à plusieurs semaines, par exemple) et lancer une tâche asynchrone prise en charge par Microsoft 365.
  2. Veillez à suivre l’état de la recherche jusqu’à ce que le fichier CSV soit prêt, puis téléchargez les données et conservez-les avec leurs métadonnées : heure de début, plage de dates, demandeur et titre du rapport, afin de garantir la cohérence des audits.
  3. Planifiez des recherches historiques automatisées, hebdomadaires ou mensuelles, pour vos rapports de conformité.

Phase 2 : choisir la bonne interface pour la revue et la validation

Il est également important de choisir la bonne interface pour examiner les résultats du suivi des messages Microsoft, afin de gagner en efficacité et en précision. PowerShell apporte l’automatisation et davantage de contrôle, tandis que les portails Microsoft 365 offrent un accès visuel rapide et manuel.

  • Utilisez le portail Microsoft Defender et le centre d’administration Exchange lorsque vous devez :
    • vérifier des messages précis
    • confirmer les résultats obtenus avec PowerShell
    • consulter le statut de distribution
    • filtrer les actions
    • examiner les détails chronologiques sans exécuter de commandes.
  • Utilisez PowerShell comme méthode de référence pour exporter, filtrer et journaliser les suivis. Vous garantissez ainsi :
    • la cohérence entre les différentes analyses
    • une automatisation reproductible au service de la gouvernance
    • des données complètes pour la documentation de conformité

Phase 3 : exporter, normaliser et enrichir

Préparez ensuite les données de suivi des messages pour l’analyse et la conformité. Les sorties brutes de PowerShell sont utiles, mais il convient de les normaliser et de les enrichir pour rendre les rapports plus faciles à interpréter et à défendre lors des audits.

  1. Enregistrez les résultats des suivis au format CSV pour faciliter la consultation, le tri et le partage au sein des équipes opérationnelles. Les exports JSON constituent également une entrée souple pour les tableaux de bord, les pipelines de données ou les systèmes SIEM.
  2. Rendez les données plus exploitables en créant de nouveaux champs calculés (TimeSpanMinutes et DeliveryOutcome, par exemple) pour repérer rapidement les tendances et les problèmes de performance.
  3. Documentez toujours les paramètres et filtres appliqués, la version du script qui a généré le rapport et le nombre d’enregistrements retournés : vous obtenez ainsi une piste d’audit plus transparente, facile à valider et à reproduire par la suite.

Phase 4 : automatiser avec une authentification sécurisée

Lorsque vous collectez des preuves sur de nombreux tenants, l’automatisation du suivi des messages garantit cohérence et auditabilité. Concentrez-vous sur une authentification sécurisée non interactive, une exécution résiliente et une journalisation claire des exécutions pour obtenir des résultats fiables et reproductibles.

  1. Pour les tâches non interactives, privilégiez l’authentification par certificat en mode application uniquement afin d’éviter le stockage de mots de passe utilisateur et les prompts de MFA (authentification forte), et n’attribuez que les rôles Exchange strictement nécessaires.
  2. Renouvelez les certificats, restreignez l’accès aux clés privées et surveillez les dates d’expiration pour que les tâches planifiées continuent de s’exécuter en toute sécurité.
  3. Mettez en place une logique de nouvelle tentative pour les incidents transitoires connus (coupures réseau, limitation de débit du service, etc.) afin d’éviter qu’une tâche longue échoue à cause d’un simple aléa. Prévoyez un comportement de contournement ou de reprise propre et des messages d’erreur explicites pour faciliter l’analyse post-mortem.
  4. Planifiez des suivis en direct quotidiens pour une visibilité immédiate et des recherches historiques hebdomadaires pour une couverture plus large, puis consignez les heures de début et de fin, le fuseau horaire, les paramètres, le nombre d’éléments et les échecs dans un emplacement centralisé. Adoptez une convention de nommage cohérente et configurez des alertes sur les anomalies (aucun résultat, taux d’échec élevé, etc.) pour identifier et traiter les problèmes de manière proactive.

Phase 5 : industrialiser le suivi pour les enquêtes et les audits

Enfin, vous devez industrialiser le suivi des messages pour que chaque exécution serve vos enquêtes, vos audits et votre gouvernance. Standardisez la manière dont les résultats sont stockés, référencés et corrélés afin de constituer un historique solide des contrôles de flux de messagerie et des actions de réponse aux incidents.

  1. Joignez directement les exports de suivi des messages aux tickets d’incident, aux chronologies de dossiers ou aux systèmes de documentation, pour créer une chaîne de preuves claire montrant quand les messages ont été envoyés, quel chemin ils ont suivi et pourquoi la distribution a abouti à tel résultat.
  2. Conservez chaque mois des échantillons de suivis représentatifs pour vérifier que les contrôles de sécurité, de filtrage et de routage fonctionnent comme prévu. Ces échantillons archivés apportent également une preuve mesurable de la bonne santé opérationnelle et de l’application des politiques.
  3. Comparez les anomalies de suivi des messages aux modifications des rôles d’administration, des licences utilisateur ou des règles de boîtes aux lettres afin de détecter les dérives de configuration, les abus de privilèges ou les exceptions de politique susceptibles d’expliquer un comportement inhabituel du flux de messagerie ou des lacunes de conformité.

Tableau récapitulatif des bonnes pratiques

Voici un tableau des bonnes pratiques qui garantissent un suivi des messages Microsoft 365 précis et sécurisé à des fins d’audit.

PratiqueObjectifBénéfice apporté
Cmdlets de suivi en direct V2Interface actuelle pour les messages récentsDes réponses plus rapides avec une sortie homogène
Recherche historiqueJeux de données volumineux et anciensCouverture complète sans délai d’expiration
Automatisation en mode application uniquementPlanifications sécurisées et non interactivesExécutions sans surveillance fiables et conformes
Exports normalisésReporting standardisé et structuréJointures de données et intégration aux tableaux de bord facilitées
Preuves adaptées à l’auditExécutions journalisées et nombre d’enregistrementsTraçabilité pour les enquêtes et les revues

L’intérêt de PowerShell pour générer des rapports de suivi des messages dans Microsoft 365

Générer des rapports de suivi des messages Microsoft 365 avec PowerShell offre une méthode plus rapide et reproductible pour analyser le flux de messagerie sur plusieurs tenants. Contrairement à l’interface graphique du centre d’administration Exchange, PowerShell apporte l’automatisation et un filtrage plus précis, idéal pour les enquêtes et les rapports de conformité récurrents. Parmi les principaux avantages, vous pouvez :

  • planifier des suivis et des exports sans intervention manuelle ;
  • traiter efficacement de vastes jeux de données et de longues plages de dates ;
  • appliquer des filtres exacts sur l’expéditeur, le destinataire ou le statut ;
  • journaliser les paramètres, les horodatages et les résultats pour assurer la traçabilité ;
  • alimenter des outils de surveillance ou des tableaux de bord de gouvernance avec vos rapports.

Exemple de point d’automatisation

Les MSP peuvent recourir à l’automatisation pour intégrer le suivi des messages à leurs opérations quotidiennes. Ils assurent ainsi une collecte de preuves cohérente et des informations à jour, sans effort manuel. Voici un exemple de workflow pour une tâche PowerShell planifiée qui rationalise le suivi, le reporting et la documentation :

  • Tâche de suivi en direct quotidienne : exécute Get-MessageTraceV2 toutes les 24 heures pour capturer l’activité de distribution récente.
  • Enrichissement des détails : utilise Get-MessageTraceDetailV2 pour ajouter les données saut par saut de chaque message.
  • Export structuré : écrit les résultats dans un fichier CSV nommé avec des horodatages et des identifiants de tenant pour un suivi facile.
  • Export historique hebdomadaire : exécute Start-HistoricalSearch une fois par semaine pour générer un jeu de données de 10 jours destiné à une analyse plus large.
  • Journalisation des exécutions : consigne les heures de début et de fin, le nombre d’éléments, la durée et les paramètres de filtrage à des fins d’audit.
  • Reporting automatisé : publie un résumé concis des résultats dans l’espace de documentation ou de surveillance pour une visibilité immédiate.

Intégration NinjaOne

NinjaOne peut être intégré au suivi des messages Microsoft 365 pour aider les MSP à automatiser différentes tâches depuis leur plateforme de gestion. De quoi simplifier les workflows de conformité et renforcer la visibilité.

Tâche d’intégrationObjectifBénéfice apporté
Déployer et planifier des scriptsAutomatiser les tâches PowerShell de suivi des messages depuis la console NinjaOneGarantit une génération de rapports cohérente et sans surveillance chez tous les clients
Stocker les identifiants en toute sécuritéConserver les identifiants d’administration ou d’application chiffrés dans le coffre d’identifiants de NinjaOneProtège les accès sensibles et facilite la conformité
Joindre les exports et les journauxTéléverser les fichiers CSV et les journaux d’exécution dans la documentation clientCentralise les preuves pour les enquêtes et les audits
Synthétiser les indicateurs clésAfficher les totaux quotidiens et les statuts de messages notables dans des tableaux de bord ou des rapportsOffre une vision opérationnelle immédiate et alimente les rapports trimestriels d’activité

Une conformité fiable grâce au suivi des messages piloté par PowerShell

Les administrateurs et les MSP peuvent gagner en rapidité et en précision dans leurs analyses de distribution d’e-mails en générant leurs rapports de suivi des messages Microsoft 365 avec PowerShell. Cette approche apporte un contrôle fin, l’automatisation et un reporting plus homogène, pour enquêter plus facilement sur les incidents, maintenir la conformité et documenter la santé de la distribution. En associant l’automatisation aux étapes décrites dans cet article, vous faites de chaque exécution de suivi un gage de transparence et de responsabilité.

Sujets connexes :

FAQs

Microsoft 365 conserve les données de suivi des messages jusqu’à 10 jours pour les suivis en direct et 90 jours pour les recherches historiques. Les données plus anciennes ne sont accessibles que si elles ont été exportées et archivées manuellement pendant la période de conservation correspondante.

Get-MessageTraceV2 sert aux suivis de messages récents, sur les 10 derniers jours, tandis que Start-HistoricalSearch récupère des jeux de données plus volumineux ou plus anciens, jusqu’à 90 jours. La recherche historique s’exécute de façon asynchrone et produit un fichier CSV téléchargeable.

Le suivi des messages aide à identifier les chemins de distribution et les actions de filtrage de sécurité, ce qui peut révéler si un message a été signalé comme spam, usurpé ou relevant du phishing. Une analyse de sécurité plus poussée doit toutefois être menée avec Defender pour Office 365 ou des outils d’investigation des menaces.

PowerShell permet une journalisation, un horodatage et une conservation des preuves cohérents pendant le suivi des messages. Chaque rapport peut ainsi être reproduit, vérifié et joint à la documentation d’audit lors des revues de conformité.

Les administrateurs rencontrent souvent des problèmes d’autorisations, des limitations de débit ou des sessions expirées. Ces difficultés peuvent être évitées en recourant à l’authentification en mode application uniquement, en mettant en place une logique de nouvelle tentative pour les erreurs transitoires et en configurant correctement les accès basés sur les rôles.

Il est recommandé de réaliser des suivis en direct quotidiens et des recherches historiques hebdomadaires ou mensuelles pour assurer une surveillance continue. Cet équilibre garantit une détection rapide des problèmes de distribution et une collecte régulière de preuves pour les revues de conformité et d’exploitation.

You might also like

Prêt à simplifier les aspects les plus complexes de l'informatique et de la sécurité ?