Skip to main content

Installation guide

  • Install the Maester PowerShell module, Pester, and the out of the box tests.
Install-Module Pester -SkipPublisherCheck -Force -Scope CurrentUser
Install-Module Maester -Scope CurrentUser

md maester-tests
cd maester-tests
Install-MaesterTests
  • Sign into your Microsoft 365 tenant and run the tests.
Connect-Maester
Invoke-Maester

Invoke-Maester​

To learn more about the Invoke-Maester cmdlet including how to filter tests, and customize the run of the Pester Configuration see the Invoke-Maester documentation.

Optional modules and permissions​

Maester includes optional CISA tests that require additional permissions and modules to run. These optional tests are skipped if the modules are not installed or there is no active connection.

Installing Azure and Exchange Online modules​

Install-Module Az -Scope CurrentUser
Install-Module ExchangeOnlineManagement -Scope CurrentUser

The Security & Compliance PowerShell module is dependent on the ExchangeOnlineManagement Connect-IPPSSession cmdlet.

Connecting to Azure, Exchange and other services​

In order to run all the CISA tests, you need to connect to the Azure, Exchange Online, and other modules.

For a more detailed introduction to these concepts see the Connect-Maester documentation.

Run the following command to interactively connect to the Azure, Exchange Online, and other modules. A sign in window will appear for each module.

Connect-Maester -Service All

Permissions​

Exchange Online implements a role-based access control model. The controls these cmdlets test, require minimum roles of either of the following:

  • View-Only Configuration OR
  • O365SupportViewConfig

Next Steps​