Open source · PowerShell
Microsoft Extractor Suite
Acquire Microsoft 365, Entra ID and Azure logs in a forensically sound format, including past the limits of the portal export. Built during our own investigations; used by security teams we have never met.
# Install from the PowerShell Gallery
Install-Module -Name Microsoft-Extractor-Suite
Import-Module Microsoft-Extractor-Suite
# Connect read-only, then pull the audit log
Connect-M365
Get-UAL -StartDate "2026-09-01"
✓ records written to ./OutputWhat it does
Logs in, evidence out
Read-only. Every record is written with the query that produced it, so the acquisition can be repeated and checked.
What it collects
Sources, by platform
A selection. The docs list every source and its parameters.
| Platform | Source | Command |
|---|---|---|
| Microsoft 365 | Unified audit log | Get-UAL |
| Microsoft 365 | Mailbox audit log | Get-MailboxAuditLog |
| Microsoft 365 | Message trace | Get-MessageTraceLog |
| Microsoft 365 | Inbox and transport rules | Get-MailboxRules · Get-TransportRules |
| Entra ID | Sign-in logs | Get-GraphEntraSignInLogs |
| Entra ID | Audit logs | Get-GraphEntraAuditLogs |
| Entra ID | OAuth app permissions | Get-OAuthPermissionsGraph |
| Azure | Activity logs | Get-ActivityLogs |
Quick start
From install to evidence in four steps
- 01
Install the module
From the PowerShell Gallery. No agents, nothing installed in your tenant.
- 02
Connect with a read-only role
Your admin grants the scopes listed in the docs. Nothing is written to the tenant.
- 03
Pull the sources you need
Start with the ones that age out first: the audit log and sign-in logs.
- 04
Hand off the output
JSON or CSV, ready for a timeline tool, your SIEM, or a responder.
Where it’s used
The same tool, three ways
The first acquisition on most Microsoft cases we run.
OpenProving the evidence is there, in your tenant, before you need it.
Taught hands-on in the course labs.
Releases
What changed recently
More tools
The rest of the toolkit
Microsoft Extractor Suite
Pulled the logs and not sure what you're looking at?
A responder can read them with you.

