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.
The module is pretty simple, so far you can find:
- Connect-M365ServiceHealth
- Get-M365ServiceHealth
- Get-M365ServiceHealthIssues
The module requires an application registered in AAD. The application needs to have this permission:
- ServiceHealth.Read.All
Install-Module -Name M365ServiceHealthFirst 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.
- I plan in adding more cmdlets based on the service communications API of Microsoft Graph.
- Docs
- Better error handling
Thanks to Adam Bertram for his "Building Your First PowerShell Module" article, that help me release the very first version.