M365ServiceHealth

Introduction

Started to build this module for educational purposes and also because I am a Microsoft 365 Multi-Tenant administrator and wanted to have the service status being refreshed in a PowerShell window (or better, in a Windows Terminal pane) while working.

Cmdlets

The module is pretty simple, so far you can find:

• Connect-M365ServiceHealth
• Get-M365ServiceHealth
• Get-M365ServiceHealthIssues

Requirements

The module requires an application registered in AAD. The application needs to have this permission:

• ServiceHealth.Read.All

How to install

Install-Module -Name M365ServiceHealth

How to use

First of all, run

Connect-M365ServiceHealth 
Connect-M365ServiceHealth -ApplicationID <String> -ClientSecret <String> -TenantID <String>
Connect-M365ServiceHealth -ApplicationID <String> -CertificateThumbPrint <String> -TenantID <String>

To set the required Tenant parameters for the rest of the cmdlets.

To get an overview of Microsoft 365 Services health:

Get-M365ServiceHealth [-Refresh <UInt32>]

To get a list of unresolved issues per service:

Get-M365ServiceHealthIssues -ServiceName <String> 

By default it will refresh every 60 seconds but you can specify using -Refresh parameter.

Future

• I plan in adding more cmdlets based on the service communications API of Microsoft Graph.
• Docs
• Better error handling

Collaborators

• Andres Bohren

Acknowledgments

Thanks to Adam Bertram for his "Building Your First PowerShell Module" article, that help me release the very first version.