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.

License
GPL-2.0
Runs on
PowerShell 7 · Windows, macOS, Linux
Cost
Free
SetupPowerShell
# 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 ./Output
Works with

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

SourcesOutputsExtractor SuitePowerShell
Microsoft 365
Entra ID
AzureUnifiedAuditLogEvidence export · JSON, CSVTimeline-readyYour SIEM or data lake

What it collects

Sources, by platform

A selection. The docs list every source and its parameters.

Full source list
PlatformSourceCommand
Microsoft 365Unified audit logGet-UAL
Microsoft 365Mailbox audit logGet-MailboxAuditLog
Microsoft 365Message traceGet-MessageTraceLog
Microsoft 365Inbox and transport rulesGet-MailboxRules · Get-TransportRules
Entra IDSign-in logsGet-GraphEntraSignInLogs
Entra IDAudit logsGet-GraphEntraAuditLogs
Entra IDOAuth app permissionsGet-OAuthPermissionsGraph
AzureActivity logsGet-ActivityLogs

Quick start

From install to evidence in four steps

  1. 01

    Install the module

    From the PowerShell Gallery. No agents, nothing installed in your tenant.

  2. 02

    Connect with a read-only role

    Your admin grants the scopes listed in the docs. Nothing is written to the tenant.

  3. 03

    Pull the sources you need

    Start with the ones that age out first: the audit log and sign-in logs.

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

ServiceIncident response

The first acquisition on most Microsoft cases we run.

Open
ServiceForensic Readiness Review

Proving the evidence is there, in your tenant, before you need it.

AcademyIncident response in the Microsoft cloud

Taught hands-on in the course labs.

Releases

What changed recently

All releases

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.