/Microsoft365DSC

Manages, configures, extracts and monitors Microsoft 365 tenant configurations

Primary LanguagePowerShellMIT LicenseMIT

Microsoft365DSC

This module allows organizations to automate the deployment, configuration, 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 templates, please navigate to the official web site at Microsoft365DSC.com and check out the official YouTube channel Microsoft365DSC.

Branches

master

Build status codecov

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

dev

Build status

codecov

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

AzureCloud - Integration

AzureUSGovernment - Integration

Generate Wiki Content

Unit Tests

This is the development branch to which contributions should be proposed by contributors as pull requests. This development branch will periodically be merged to the master branch, and be released to PowerShell Gallery.

How to Install

In order to acquire the latest bits of the module from a machine that has internet connectivity, simply run the following PowerShell line:

Install-Module -Name Microsoft365DSC -Force

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 being captured, App Insights which is used for the analytics of the Telemetry, does capture information about the city where the telemetry entries where captured from by default. Users can opt out to prevent telemetry to be sent back to the Microsoft365DSC team by running the following command:

Set-M365DSCTelemetryOption -Enabled $False