Skip to content

Manages, configures, extracts and monitors Microsoft 365 tenant configurations

License

Notifications You must be signed in to change notification settings

microsoft/Microsoft365DSC

Repository files navigation

Microsoft365DSC

This module allows organizations to automate the deployment, configuration, reporting and monitoring of Microsoft 365 Tenants via PowerShell Desired State Configuration. The compiled configuration needs to be executed from an agent's Local Configuration Manager (LCM) (machine or container) which can communicate back remotely to Microsoft 365 via remote API calls (therefore requires internet connectivity)

For information on how to get started, additional documentation or additional resources, please navigate to the official web site at Microsoft365DSC.com and check out the official YouTube channel Microsoft365DSC.

Roadmap & Backlog

We are using Azure DevOps for project management. You can access our backlog and roadmap by clicking on the status badge below:

Board Status

Branches

master

codecov

This is the branch containing the latest release. No contributions should be made directly to this branch.

dev

Code Coverage

AzureCloud - Full-Circle - EXO

AzureCloud - Full-Circle - O365

AzureCloud - Full-Circle - OD

AzureCloud - Full-Circle - PP

AzureCloud - Full-Circle - SC

AzureCloud - Full-Circle - SPO

AzureCloud - Full-Circle - TEAMS

Global - Integration - AAD

Global - Integration - EXO

Global - Integration - INTUNE

Unit Tests

Contributors are encouraged to propose their contributions as pull requests to this development branch. This branch will periodically be merged to the master branch, and be released to PowerShell Gallery.

How to Install

To acquire the latest bits of the module from a machine that has internet connectivity, run the following PowerShell lines:

Install-Module -Name Microsoft365DSC -Force
Update-M365DSCModule

Telemetry Disclaimer

Microsoft365DSC captures Telemetry data about the names of the resources in which a configuration drift has been detected, along with the type of exceptions being thrown by errors in the various modules. While no sensitive data is ever captured, App Insights, which performs telemetry analytics, captures information about the city where the telemetry entries were captured by default. Users can opt-out to prevent telemetry from being sent back to the Microsoft365DSC team by running the following command:

Set-M365DSCTelemetryOption -Enabled $False