Install

Guerrilla installs from the PowerShell Gallery as the module named Guerrilla. It needs PowerShell 7.0 or later and runs on Windows, macOS, and Linux.

With PSResourceGet (PowerShell 7.4+ in the box, or install Microsoft.PowerShell.PSResourceGet):

Install-PSResource Guerrilla

With the classic PowerShellGet cmdlets:

Install-Module Guerrilla -Scope CurrentUser

First run

Import the module and run Show-Guerrilla to open the Operations Console: run scans, manage the credential Safehouse, browse reports, and tune settings. Or go straight to an audit:

Import-Module Guerrilla
Show-Guerrilla

# or run an audit directly
Invoke-EntraAudit

Credentials

Set-Safehouse stores assessment credentials in a per-user SecretManagement vault, so scheduled or repeated runs need no secrets on the command line. Guerrilla is read-only: grant it read access, and that is all it will ever use.

Rename note

This module was published as PSGuerrilla through version 2.46.1 and is Guerrilla from 2.46.3 on. Existing installs migrate automatically; per-user data and Safehouse credentials carry forward.