Update 7/12/2023: This project has been superseded by Microsoft's project found here and is now officially deprecated. There will no longer be any updates to this project. It was fun while it lasted!
A Powershell module for retrieving data from the Office 365 Service Communications API. This could be used for reporting the health status of your tenant over time, or for alerting when new incidents are posted.
You'll need to start by registering an application with the appropriate permissions in the Azure Active Directory associated with your Office 365 tenant. Instructions for that can be found here.
To install this module from the PowerShell Gallery, run Install-Module O365ServiceCommunications.
The original version of the Service Communications API has now been deprecated, and V2 is now the officially supported API. These APIs share little in common, so updating this module to support the new API is a breaking change. For that reason, the major version of this module follows the API version - 1.. refers to the module supporting the original API and 2.. is the version that supports the V2 API. Versions of the module prior to 2.0.0 will eventually be unlisted from the PowerShell Gallery since the original API is no longer available.
Note: V2 of this module is currently in preview. It is working but needs testing and better documentation. Please consider helping me out by installing and testing it, and reporting any issues you might have. While this module is in preview, you'll need to run
Install-Module O365ServiceCommunications -AllowPrereleaseto install the preview version.
Use this function to authenticate to the Service Communications API and retrieve an access token. This will create a pseudo-persistent connection to the API that will be used for subsequent calls. Removing or re-importing the module will break this connection.
Returns information about what services are available in your tenant.
Returns current or historical status for services in your tenant.
Returns messages from the Service Communications API.
With this PowerShell module you could:
- Present an HTML report of Office 365 Service Health
- Generate an email alert when new incidents are posted to your tenant
- Post alerts to the team chat service of your choice
- And many more! 😆
| Azure Pipelines | PowerShell Gallery | Github |
|---|---|---|
 |
 |
 |
Any contributions to the project are welcome and could come in the form of issues, fixes, new features, tests, or even help documentation. Just submit an issue or PR and I'll review ASAP.
Note: I'd really appreciate some additional testers, both for administrators of an Office 365 tenant and partners who provide support for several client tenants. Please try the preview module out and submit issues for any problems you encounter. Thanks!