PAX v1.7.0
·
457 commits
to release
since this release
Release Notes: v1.7.0
Release Information
- Version: 1.7.0
- Release Date: 2025-10-14 20:18:17 UTC
- Released By: Brian Middendorf (@microsoft)
- Previous Version: v1.6.0
Overview
What Changed
- PowerShell Scripts: 18 file(s) modified
- Documentation: 14 file(s) modified
- Configuration Files: 5 file(s) modified
- Source Code: 20 file(s) modified
- GitHub Workflows: 2 file(s) modified
Version 1.7.0 delivers critical bug fixes, powerful new user/group filtering capabilities, and enhanced conversation analysis features for the Portable Audit eXporter (PAX). This release resolves PowerShell type ambiguity issues, introduces flexible filtering options for user-specific analysis, and provides granular control over conversation turn isolation.
Key Highlights
New User and Group Filtering
- UserIds Parameter: Filter audit logs to specific user identifiers
- Live mode: Server-side filtering at Purview (efficient, no unnecessary data transfer)
- Replay mode: Client-side filtering from AuditData JSON
- Supports single or multiple users:
-UserIds "user@contoso.com"or-UserIds "user1@contoso.com","user2@contoso.com"
- GroupNames Parameter: Filter to members of distribution or security groups (Live mode only)
- Automatic group expansion using Get-DistributionGroupMember
- Supports multiple groups:
-GroupNames "Executive Team","Engineering Managers" - Can be combined with UserIds for comprehensive targeting
Enhanced Conversation Filtering
- PromptFilter Feature: Three-mode system for conversation turn analysis
Prompt: Isolate user prompts for input analysisResponse: Isolate Copilot responses for output analysisBoth: Include only conversation turns with explicit prompt/response indicatorsNull: Include only turns where isPrompt is undefined- Uses two-stage filtering (pre-explosion + during explosion) for optimal performance
- ExcludeAgents Switch: Filter out agent-based interactions for cleaner datasets
- Inverse of
-AgentsOnlyfor flexible workflow design - Useful for focusing on non-agent Copilot interactions
- Inverse of
Critical Bug Fixes
- Fixed PowerShell type ambiguity errors that caused script failures when combining multiple filter switches (e.g., UserIds + AgentsOnly)
- Resolved variable name collisions between progress tracking and elapsed time calculations in all filtering sections
- Added explicit [int] type casts throughout filtering logic to prevent "ambiguous overloads" errors
- Fixed blank Message_isPrompt values appearing in output data
Reporting Improvements
- Explosion metrics now clearly differentiate between:
- Multi-row records (conversation threads with multiple turns)
- Single-row records (standalone interactions)
- Total records processed
- Enhanced filter display to show UserIds and GroupNames in execution summary
- Better visibility into data transformation during array explosion
Detailed Changes
Modified Files (81 files changed)
.devcontainer/.gitkeep
.gitattributes
.github/.gitkeep
.github/workflows/.gitkeep
.gitignore
.tauriignore
.vscode/.gitkeep
CODE_OF_CONDUCT.md
CONTRIBUTORS.md
LICENSE
MAC_USER_GUIDE.md
PAX.code-workspace
PAX_Documentation_v1.7.0.pdf
PAX_Overview.pdf
PAX_Purview_Audit_Log_Processor_v1.7.0.ps1
README.md
README.md.backup
SECURITY.md
index.html
package-lock.json
package.json
postcss.config.js
release_documentation/.gitkeep
release_documentation/Purview_Audit_Log_Processor/.gitkeep
release_documentation/Purview_Audit_Log_Processor/MD/.gitkeep
release_documentation/Purview_Audit_Log_Processor/MD/PAX_Documentation_v1.6.0.md
release_documentation/Purview_Audit_Log_Processor/MD/PAX_Documentation_v1.7.0.md
release_documentation/Purview_Audit_Log_Processor/PDF/.gitkeep
release_documentation/Purview_Audit_Log_Processor/PDF/PAX_Documentation_v1.6.0.pdf
release_documentation/Purview_Audit_Log_Processor/PDF/PAX_Documentation_v1.7.0.pdf
release_notes/.gitkeep
release_notes/Purview_Audit_Log_Processor/.gitkeep
release_notes/Purview_Audit_Log_Processor/v1.6.0.md
release_notes/Purview_Audit_Log_Processor/v1.7.0.md
release_notes/v1.6.0.md
script_archive/.gitkeep
script_archive/Purview_Audit_Log_Processor/.gitkeep
script_archive/Purview_Audit_Log_Processor/PAX_Purview_Audit_Log_Processor_v1.6.0.ps1
script_archive/Purview_Audit_Log_Processor/PAX_Purview_Audit_Log_Processor_v1.7.0.ps1
scripts/.gitkeep
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.4.2.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.4.3.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.4.4.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.4.5.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.4.6.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.4.7.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.0.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.1.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.2.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.3.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.5.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.6.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.7.ps1
scripts/LegacyScripts/PAX_Purview_Audit_Log_Processor_v1.5.8.ps1
scripts/release.ps1
src-tauri/.gitkeep
src-tauri/Cargo.lock
src-tauri/Cargo.toml
src-tauri/icons/128x128.png
src-tauri/icons/128x128@2x.png
src-tauri/icons/32x32.png
src-tauri/icons/Square107x107Logo.png
src-tauri/icons/Square142x142Logo.png
src-tauri/icons/Square150x150Logo.png
src-tauri/icons/Square284x284Logo.png
src-tauri/icons/Square30x30Logo.png
src-tauri/icons/Square310x310Logo.png
src-tauri/icons/Square44x44Logo.png
src-tauri/icons/Square71x71Logo.png
src-tauri/icons/Square89x89Logo.png
src-tauri/icons/StoreLogo.png
src-tauri/icons/icon-fixed.png
src-tauri/icons/icon.icns
src-tauri/icons/icon.ico
src-tauri/icons/icon.png
src-tauri/tauri.conf.json
src/.gitkeep
tailwind.config.js
temp_header.txt
tsconfig.json
vite.config.ts
File Statistics
.devcontainer/.gitkeep | 0 .gitattributes | 1 + .github/.gitkeep | 0 .github/workflows/.gitkeep | 0 .gitignore | 1 + .tauriignore | 1 + .vscode/.gitkeep | 0 CODE_OF_CONDUCT.md | 1 + CONTRIBUTORS.md | 1 + LICENSE | 1 + MAC_USER_GUIDE.md | 114 - PAX.code-workspace | 1 + PAX_Documentation_v1.7.0.pdf | Bin 0 -> 4248511 bytes PAX_Overview.pdf | Bin 184400 -> 0 bytes ...1 => PAX_Purview_Audit_Log_Processor_v1.7.0.ps1 | 624 ++++- README.md | 459 +++- README.md.backup | 2521 -------------------- SECURITY.md | 1 + index.html | 1 + package-lock.json | 1 + package.json | 3 +- postcss.config.js | 1 + release_documentation/.gitkeep | 3 + .../Purview_Audit_Log_Processor/.gitkeep | 2 + .../Purview_Audit_Log_Processor/MD/.gitkeep | 2 + .../MD/PAX_Documentation_v1.6.0.md | 1198 ++++++++++ .../MD/PAX_Documentation_v1.7.0.md | 1510 ++++++++++++ .../Purview_Audit_Log_Processor/PDF/.gitkeep | 2 + .../PDF/PAX_Documentation_v1.6.0.pdf | Bin 0 -> 4100013 bytes .../PDF/PAX_Documentation_v1.7.0.pdf | Bin 0 -> 4255157 bytes release_notes/.gitkeep | 0 release_notes/Purview_Audit_Log_Processor/.gitkeep | 0 .../Purview_Audit_Log_Processor/v1.6.0.md | 251 ++ .../Purview_Audit_Log_Processor/v1.7.0.md | 126 + release_notes/v1.6.0.md | 146 -- script_archive/.gitkeep | 0 .../Purview_Audit_Log_Processor/.gitkeep | 0 .../PAX_Purview_Audit_Log_Processor_v1.6.0.ps1 | 600 ++++- .../PAX_Purview_Audit_Log_Processor_v1.7.0.ps1 | 886 ++++++- scripts/.gitkeep | 0 .../PAX_Purview_Audit_Log_Processor_v1.4.2.ps1 | 1383 ----------- .../PAX_Purview_Audit_Log_Processor_v1.4.3.ps1 | 1501 ------------ .../PAX_Purview_Audit_Log_Processor_v1.4.4.ps1 | 1508 ------------ .../PAX_Purview_Audit_Log_Processor_v1.4.5.ps1 | 1612 ------------- .../PAX_Purview_Audit_Log_Processor_v1.4.6.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.4.7.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.0.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.1.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.2.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.3.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.5.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.6.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.7.ps1 | 1624 ------------- .../PAX_Purview_Audit_Log_Processor_v1.5.8.ps1 | 1624 ------------- scripts/release.ps1 | 595 ++++- src-tauri/.gitkeep | 0 src-tauri/Cargo.lock | 2 +- src-tauri/Cargo.toml | 2 +- src-tauri/icons/128x128.png | Bin 10165 -> 4571 bytes src-tauri/icons/128x128@2x.png | Bin 23043 -> 12825 bytes src-tauri/icons/32x32.png | Bin 2654 -> 253 bytes src-tauri/icons/Square107x107Logo.png | Bin 8569 -> 3721 bytes src-tauri/icons/Square142x142Logo.png | Bin 11762 -> 5582 bytes src-tauri/icons/Square150x150Logo.png | Bin 12690 -> 6081 bytes src-tauri/icons/Square284x284Logo.png | Bin 29025 -> 15194 bytes src-tauri/icons/Square30x30Logo.png | Bin 2398 -> 664 bytes src-tauri/icons/Square310x310Logo.png | Bin 33111 -> 17553 bytes src-tauri/icons/Square44x44Logo.png | Bin 3515 -> 1039 bytes src-tauri/icons/Square71x71Logo.png | Bin 5670 -> 2069 bytes src-tauri/icons/Square89x89Logo.png | Bin 7134 -> 2779 bytes src-tauri/icons/StoreLogo.png | Bin 3947 -> 1221 bytes src-tauri/icons/icon-fixed.png | Bin 0 -> 255 bytes src-tauri/icons/icon.icns | Bin 407796 -> 207186 bytes src-tauri/icons/icon.ico | Bin 40305 -> 18284 bytes src-tauri/icons/icon.png | Bin 65482 -> 36282 bytes src-tauri/tauri.conf.json | 4 +- src/.gitkeep | 0 tailwind.config.js | 1 + temp_header.txt | 2 + tsconfig.json | 1 + vite.config.ts | 1 + 81 files changed, 5882 insertions(+), 25428 deletions(-)
Commit History
c6c87a2 - v1.7.0 (Brian Middendorf, 5 hours ago) f950d46 - v1.7.0 (Brian Middendorf, 5 hours ago) 037227a - v1.7.0 (Brian Middendorf, 5 hours ago) 9b4ec42 - v1.7.0 (Brian Middendorf, 5 hours ago) b358db0 - v1.6.0 (Brian Middendorf, 5 hours ago) 97e522b - v1.7.0 (Brian Middendorf, 5 hours ago) 94d8cf3 - v1.7.0 (Brian Middendorf, 5 hours ago) 8c95538 - v1.7.0 (Brian Middendorf, 5 hours ago) 9c39cb4 - v1.7.0 (Brian Middendorf, 5 hours ago) b1c56a2 - v1.7.0 (Brian Middendorf, 5 hours ago) 4afde86 - v1.7.0 (Brian Middendorf, 5 hours ago) 73b33e9 - v1.7.0 (Brian Middendorf, 5 hours ago) 2c3ce00 - v1.7.0 (Brian Middendorf, 5 hours ago) 3468403 - Update release.ps1: Add mailto link with version-specific pre-populated subject line (Brian Middendorf, 6 hours ago) 6c6b0b9 - v1.7.0 (Brian Middendorf, 6 hours ago) ac4cb00 - v1.6.0 (Brian Middendorf, 6 hours ago) 7f5353c - Update release.ps1: Support section with version-specific documentation link, removed feedback (Brian Middendorf, 6 hours ago) 586eb28 - v1.7.0 (Brian Middendorf, 6 hours ago) 37f2793 - v1.6.0 (Brian Middendorf, 6 hours ago) ac94040 - v1.6.0 (Brian Middendorf, 6 hours ago) d0b1871 - Update release.ps1: Improved Installation section format in release notes template (Brian Middendorf, 6 hours ago) 9490e5d - v1.7.0 (Brian Middendorf, 6 hours ago) 337a710 - v1.6.0 (Brian Middendorf, 6 hours ago) fc7b617 - v1.6.0 (Brian Middendorf, 6 hours ago) 18eb517 - v1.6.0 (Brian Middendorf, 6 hours ago) bfc55ee - v1.6.0 (Brian Middendorf, 7 hours ago) e588467 - v1.6.0 (Brian Middendorf, 7 hours ago) f153b8b - v1.6.0 (Brian Middendorf, 7 hours ago) ac83dbd - v1.7.0 (Brian Middendorf, 7 hours ago) 171e951 - v1.6.0 (Brian Middendorf, 7 hours ago) 8cece5c - v1.7.0 (Brian Middendorf, 7 hours ago) 86e2d97 - v1.6.0 (Brian Middendorf, 7 hours ago) 1aa0ede - v1.7.0 (Brian Middendorf, 7 hours ago) fae719c - v1.6.0 (Brian Middendorf, 7 hours ago) d23ee5d - v1.6.0 (Brian Middendorf, 8 hours ago) da571f4 - v1.6.0 (Brian Middendorf, 8 hours ago) a5b139a - v1.6.0 (Brian Middendorf, 8 hours ago) ebbc2d2 - v1.6.0 (Brian Middendorf, 8 hours ago) 3888db1 - v1.6.0 (Brian Middendorf, 8 hours ago) 30024ba - v1.7.0 (Brian Middendorf, 8 hours ago) 44f83cf - v1.7.0 (Brian Middendorf, 8 hours ago) a75c8ad - v1.7.0 (Brian Middendorf, 8 hours ago) a8d0848 - v1.7.0 (Brian Middendorf, 8 hours ago) 2cf91d1 - v1.7.0 (Brian Middendorf, 20 hours ago) 39f93b7 - v1.7.0 (Brian Middendorf, 20 hours ago) 599a698 - v1.7.0 (Brian Middendorf, 20 hours ago) d9a4491 - v1.7.0 (Brian Middendorf, 20 hours ago) fdba3ce - v1.7.0 (Brian Middendorf, 21 hours ago) cce6088 - v1.7.0 (Brian Middendorf, 21 hours ago) 8dac3cf - v1.7.0 (Brian Middendorf, 21 hours ago) 5da478c - Update v1.7.0 release notes with enhanced formatting and comprehensive feature descriptions (Brian Middendorf, 21 hours ago) 826d713 - v1.7.0 (Brian Middendorf, 21 hours ago) ecff843 - v1.7.0 (Brian Middendorf, 21 hours ago) 88330df - v1.7.0 (Brian Middendorf, 21 hours ago) 3c4607f - v1.7.0 (Brian Middendorf, 21 hours ago) 8a96b4f - v1.7.0 (Brian Middendorf, 21 hours ago) 1a50391 - v1.7.0 (Brian Middendorf, 21 hours ago) 61d0823 - v1.7.0 (Brian Middendorf, 21 hours ago) 90b4c50 - v1.7.0 (Brian Middendorf, 22 hours ago) c660f58 - Update release.ps1 to use Grip + wkhtmltopdf for GitHub-style PDF generation with functional links (Brian Middendorf, 22 hours ago) f1c7212 - v1.7.0 (Brian Middendorf, 22 hours ago) 43c11a2 - v1.6.0 - Combined agent filtering examples into single section (Brian Middendorf, 22 hours ago) 79da11b - v1.6.0 (Brian Middendorf, 22 hours ago) 76ee1ec - v1.6.0 (Brian Middendorf, 22 hours ago) ebad4e6 - v1.6.0 (Brian Middendorf, 22 hours ago) 2b49ac5 - v1.6.0 (Brian Middendorf, 22 hours ago) 37be7a9 - v1.6.0 (Brian Middendorf, 22 hours ago) ffba560 - v1.6.0 (Brian Middendorf, 23 hours ago) f0906e9 - v1.6.0 (Brian Middendorf, 23 hours ago) aa158be - v1.6.0 (Brian Middendorf, 23 hours ago) 102b28e - v1.6.0 (Brian Middendorf, 24 hours ago) 528f7d6 - v1.6.0 (Brian Middendorf, 24 hours ago) b661105 - v1.6.0 (Brian Middendorf, 24 hours ago) 56b3b1f - v1.6.0 (Brian Middendorf, 24 hours ago) 48479a3 - v1.6.0 (Brian Middendorf, 24 hours ago) f9820f7 - v1.6.0 (Brian Middendorf, 24 hours ago) 519ff0d - v1.6.0 (Brian Middendorf, 24 hours ago) 578bd1c - v1.6.0 (Brian Middendorf, 24 hours ago) 49693a5 - v1.6.0 (Brian Middendorf, 24 hours ago) 47aebfd - v1.6.0 (Brian Middendorf, 24 hours ago) 646c622 - v1.6.0 (Brian Middendorf, 25 hours ago) 2647555 - v1.6.0 (Brian Middendorf, 25 hours ago) 5fc8c8f - v1.6.0 (Brian Middendorf, 25 hours ago) 927ef10 - v1.6.0 (Brian Middendorf, 25 hours ago) dcc93a7 - v1.6.0 (Brian Middendorf, 25 hours ago) 451a9b7 - v1.6.0 (Brian Middendorf, 26 hours ago) 718a01b - v1.6.0 (Brian Middendorf, 26 hours ago) 62ca03d - v1.6.0 (Brian Middendorf, 26 hours ago) 89fbadd - v1.6.0 (Brian Middendorf, 26 hours ago) 56b6853 - v1.6.0 (Brian Middendorf, 26 hours ago) 935aab0 - v1.6.0 (Brian Middendorf, 26 hours ago) f63354c - v1.6.0 (Brian Middendorf, 26 hours ago) bfb1dd7 - v1.6.0 (Brian Middendorf, 26 hours ago) 3053d11 - v1.6.0 (Brian Middendorf, 2 days ago) 55b6aa8 - v1.6.0 (Brian Middendorf, 2 days ago) c728f41 - v1.6.0 (Brian Middendorf, 2 days ago) 6988089 - v1.6.0 (Brian Middendorf, 2 days ago) 573aec5 - v1.6.0 (Brian Middendorf, 2 days ago) d72643f - v1.6.0 (Brian Middendorf, 2 days ago) 2e0cf91 - v1.6.0 (Brian Middendorf, 2 days ago)
Installation
Download v1.7.0 (This Version)
This release note documents version 1.7.0. Use the direct download links below to obtain this specific version:
- Script v1.7.0: PAX_Purview_Audit_Log_Processor_v1.7.0.ps1
- Documentation v1.7.0: PAX_Documentation_v1.7.0.pdf
Get Latest Version
For the most recent release, visit:
- Latest Script Archive: Microsoft PAX Repository - Script Archive
- All Release Notes: Microsoft PAX Repository - Release Notes
Support
For questions or issues, refer to the documentation:
- Documentation v1.7.0 (PDF): PAX_Documentation_v1.7.0.pdf
- Documentation v1.7.0 (Markdown): PAX_Documentation_v1.7.0.md
Managed and released by the Microsoft Copilot Growth ROI Advisory Team. Please reach out to Brian Middendorf with any feedback.
Contributors
microsoft