Summary
Table of Contents
- Get-MailDetailTransportRuleReport and Get-MailTrafficPolicyReport will only return transport rule data when the caller explicitly includes -EventType TransportRuleHits or -EventType TransportRuleActionHits.
- Affected parties: Exchange Online administrators, messaging/security/compliance teams, and any automation, scheduled jobs, or reports that rely on these two cmdlets.
- Action required: review and update all PowerShell scripts and automation that call these cmdlets to include the correct -EventType parameter and validate changes in a test/non-production environment.
- Update runbooks, internal documentation, and notify messaging/security operations to avoid empty or incomplete transport-rule reports.
Primary Service: Exchange
Admin Impact: High
User Impact: Low
Release Start: 30 Jul 2026
Release End: 30 Jul 2026
Services: Exchange, PowerShell
Category: Plan for change
Tags: Admin Action, Feature Update, User Adoption
History
5/26/2026 Item Added to Message Center
Microsoft Message
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.