maester365/Run Maester
Monitor your Microsoft 365 tenant's security configuration using Maester, THE PowerShell-based test automation framework.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 6, 2026
- License
- MIT
Pinned Snippet
uses: maester365/maester-action@910da5adbc61adcd6464ee69e3ab15805c1ad213 # v1.2.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| tenant_id | Entra ID Tenant ID | yes | — |
| client_id | App Registration Client ID | yes | — |
| include_public_tests | Include public test repository 'maester365/maester-tests' as well as private tests in the test run | no | true |
| include_private_tests | Checkout the current repository for private tests. Disable this if you want to run the public tests only. | no | true |
| include_exchange | Include Exchange Online tests in the test run. | no | false |
| include_teams | Include Teams tests in the test run. | no | true |
| include_longrunning_tests | Include long running tests. | no | false |
| include_preview_tests | Include preview tests. | no | false |
| include_tags | A list of tags to include in the test run. Please separate multiple tags with a comma (without space). | no | "" |
| exclude_tags | A list of tags to exclude from the test run. Please separate multiple tags with a comma (without space). | no | "" |
| maester_version | The version of Maester PowerShell to use. latest (default), preview, or a specific version number. | no | latest |
| pester_verbosity | Pester verbosity level. Options: 'None', 'Normal', 'Detailed', 'Diagnostic' | no | None |
| step_summary | Level of detail written to the GitHub Actions step summary. Options: 'Full' (complete report with all test details), 'Summary' (header, counts table, and per-test pass/fail list), 'Table' (header and counts table only). Use 'false' to disable. Legacy 'true' is treated as 'Full'. | no | Table |
| artifact_upload | Define whether the results are uploaded as Artifacts. | no | true |
| artifact_upload_html | Upload the self-contained HTML report as a separate artifact and add a link to it in the step summary. The artifact is uploaded with an HTML mime type so opening the link renders the report in the browser. | no | false |
| disable_telemetry | If set, telemetry information will not be logged. | no | false |
| mail_recipients | A list of email addresses to send the test results to. Please separate multiple email addresses with a comma. | no | "" |
| mail_userid | The user id of the sender of the mail. This is required since the action is using application permissions. | no | "" |
| mail_testresultsuri | Uri to the detailed test results page. | no | ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} |
| notification_teams_webhook | Webhook URL for sending test results to Teams. | no | "" |
| notification_teams_channel_id | The ID of the Teams channel to send the test results to. | no | "" |
| notification_teams_team_id | The ID of the Teams team to send the test results to. | no | "" |
Outputs
| name | description |
|---|---|
| results_json | The file location of the JSON output of the test results. |
| tests_total | The total number of tests run. |
| tests_passed | The number of tests that passed. |
| tests_failed | The number of tests that failed. |
| tests_skipped | The number of tests that were skipped. |
| result | The result of the test run. 'Failed' if any tests failed, 'Passed' if all tests passed. |