Update scripts using Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport
Starting July 30, 2026, Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport will return transport rule data only when the -EventType parameter (TransportRuleHits or TransportRuleActionHits) is explicitly specified. Administrators must update related scripts and automation before this date to avoid incomplete results. What and Why: To improve clarity, precision, and performance of transport rule reporting, Microsoft is updating the behavior of two Exchange Online reporting cmdlets. Starting July 30, 2026, Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport will return transport rule data only when the request explicitly specifies the relevant EventType. This change helps ensure that reporting queries are intentional, predictable, and aligned with how transport rule events are generated and logged. This update supports enterprise‑ready manageability by reducing ambiguous results and helping administrators build more reliable automation and compliance reporting. Rollout Schedule: General Availability (Worldwide): We will begin rolling out in late July 2026 and expect to complete by late July 2026. Impact on Your Organization: Who is affected: Exchange Online administrators Security, compliance, or messaging teams Any organization using PowerShell scripts, automation, or reporting that relies on transport rule data from these cmdlets Platforms/Services: Exchange Online Exchange Online PowerShell What will happen: Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport will no longer return transport rule results by default. Transport rule data will be returned only when one of the following parameters is explicitly included: -EventType TransportRuleHits -EventType TransportRuleActionHits Scripts or reports that do not include one of these parameters may return empty or incomplete results. This change applies only to these two cmdlets. No other Exchange Online cmdlets are affected. Action Required / Recommendations: If your organization uses these cmdlets for transport rule reporting, action is required before July 30, 2026. Recommended actions: Review all scripts, scheduled jobs, and automation that use: Get-MailDetailTransportRuleReport Get-MailTrafficPolicyReport Update queries that require transport rule results to explicitly include: -EventType TransportRuleHits or -EventType TransportRuleActionHits Validate updated scripts in a non‑production or test context. Update internal documentation and operational runbooks. Notify messaging and security operations teams of this change. Compliance considerations: This change alters how admins retrieve and report on transport rule data for compliance and auditing purposes. Message ID: MC1323250
The post Update scripts using Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport appeared first on M365 Admin.
Published on:
Learn moreWe can help you with Update scripts using Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport
If you want help implementing, troubleshooting, or improving this product, contact us and we’ll point you in the right direction.
Related posts
Microsoft Defender for Cloud Apps: Unified RBAC support for App Governance to manage NHIs
Microsoft Defender for Cloud Apps’ App Governance will support unified Defender XDR RBAC in public preview starting late November 2026, ...
Microsoft OneDrive for iPad: Presentation mode for PDFs
Microsoft OneDrive for iPad will introduce a presentation mode for PDFs, enabling a focused, view-only experience that disables free scrolling...
Microsoft Purview | Data Loss Prevention: Protection for local AI agent interactions
Microsoft Purview Data Loss Prevention is expanding to protect sensitive data in supported local AI agent interactions, allowing administrator...
Microsoft OneDrive for Windows and Mac: node_modules folders will be excluded from sync by default
Starting December 14, 2026, OneDrive for Windows and Mac will exclude new folders named “node_modules” from syncing by default to ...
Microsoft Teams: Intelligent call recap for call queues in the Queues app on mobile
Microsoft Teams mobile’s Queues app will add intelligent call recap for recorded and transcribed call queue calls starting early Decembe...
Microsoft Agent 365 Business Analytics: Introducing Access Management
Access Management for Agent 365 Business Analytics centralizes role and permission assignments for admins, combining permission sets and data ...
Autopilot availability in Frontier
Autopilot will roll out in Frontier Public starting November 17, 2026, as an always-on cloud agent requiring admin enablement and Microsoft 36...
Agent 365 Business Analytics app experience
Agent 365 Business Analytics, launching November 17, 2026, offers AI spend, usage, and value insights in Microsoft 365 admin center. Features ...
Dataverse – Dataverse Data Available in Agent Builder Declarative Agents
We are announcing the ability to select Power Platform and Dynamics 365 data as a knowledge data source when creating and editing Declarative ...
Updates available for Microsoft 365 Apps for Current Channel
We’ve released updates to the following update channel for Microsoft 365 Apps: Current Channel When this will happen: We’ll be gra...