Skip to main content
Version: 2.2.1-preview

❓ FAQ

Is this a Microsoft product?​

No. Maester is an open-source, community led project and is not affiliated with Microsoft.

How do I report issues?​

If you encounter an issue with Maester, please open an issue on GitHub.

Previously installed 'Pester' version '3.4.0' conflicts with new module​

If you see the following error when installing Maester, it means that you have an older version of Pester installed.

A Microsoft-signed module named 'Pester' with version '3.4.0' that was previously installed conflicts with the new module 'Pester'

Run the following command to install version 5.7.1 of Pester and then retry installing Maester.

Install-Module Pester -MinimumVersion 5.7.1 -MaximumVersion 5.7.1 -Scope CurrentUser -SkipPublisherCheck -Force

To learn more or if you run into Pester installation issues see Pester Installation and Update

Graph requests fail with a timeout error​

If a test run fails with an error like The request was canceled due to the configured HttpClient.Timeout of 300 seconds elapsing, the Microsoft Graph SDK default timeout has been exceeded.

This is most common when using -IncludeLongRunning in tenants with a large number of objects.

When using Connect-Maester, pass the timeout to the Microsoft Graph connection:

Connect-Maester -ClientTimeout 900
Invoke-Maester -IncludeLongRunning

If you connect to Microsoft Graph directly, set the timeout on Connect-MgGraph before running Maester:

Connect-MgGraph -Scopes (Get-MtGraphScope) -ClientTimeout 900
Invoke-Maester -SkipGraphConnect -IncludeLongRunning

When -ClientTimeout is omitted, the Microsoft Graph PowerShell SDK default is used. The timeout applies to the Graph connection rather than to an individual test or request.

Connect-Maester fails with "User canceled authentication" after an "Approval required" prompt​

Global Reader and other non-admin accounts can't consent to the Microsoft Graph permissions that Maester requests. An admin needs to grant consent first. Approving the request from Admin consent requests in the Entra admin center can fail with AADSTS70011: ... openid scope is required.

See Approval required when connecting for how an admin can grant consent from PowerShell or set up a custom app registration.