ReleaseMicrosoftMicrosoftpublished Oct 13, 2025seen Jun 26

microsoft/PAX v1.7.0

microsoft/PAX

Open original ↗

Captured source

source ↗
published Oct 13, 2025seen Jun 26captured 2whttp 200method plain

PAX v1.7.0

Repository: microsoft/PAX

Tag: v1.7.0

Published: 2025-10-13T22:39:43Z

Prerelease: no

Release notes:

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 analysis
  • Response: Isolate Copilot responses for output analysis
  • Both: Include only conversation turns with explicit prompt/response indicators
  • Null: 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 -AgentsOnly for flexible workflow design
  • Useful for focusing on non-agent Copilot interactions

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 +...

Excerpt shown — open the source for the full document.