Repository files navigation

PSDesiredStateConfiguration (DSC) is the PowerShell module that enables writing configuration as code.

The DSC platform was originally built on top of WMI for Windows. Starting in PowerShell 7.1 and workingwith internal partner teamsAzure Guest ConfigurationandAutomanage, we started makingDSC cross-platform by enablingInvoke-DSCResource to directly use resources without going throughthe Local Configuration Manager (LCM).

Our initial cross-platform work to enable partner teams:

• Separated out the DSC parts in the PowerShell engine and moved them as a subsystem into thePSDesiredStateConfiguration module
• Remove PSDesiredStateConfiguration module from the PowerShell 7 package. This allows thePSDesiredStateConfiguration module to be developed independently of PowerShell and users can mixand match versions of PowerShell and PSDesiredStateConfiguration for their environment.
  • This is now available on the PowerShell Gallery:PSDesiredStateConfiguration 2.x
• Removing the dependency on MOF: Initially, only support DSC Resources written as PowerShellclasses. This includes tooling to convert existing script based DSC Resources to be wrapped asPowerShell classes.

The documentation forPSDesiredStateConfiguration 3.0.0-beta1 is a work-in-progress. We invite thecommunity to review the documentation and assist us as we work on new documentation during the platformdevelopment.

For more information about DSC v3, seePowerShell Desired State Configuration Overview

To download the latest release from the PowerShell Gallery, seePSDesiredStateConfiguration 3.0.0-beta1

As we continue this journey to make DSC a cross-platform technology, we invite the community toshare your ideas and openissues. During the PowerShell7.3 timeframe, we remain focused on enabling partner teams and will not be accepting public pullrequests.

• Any recent PowerShell Core release to run the build script
• .NET Core SDK of the version specified inglobal.json (dotnet should be visible through PATH env var)
• PSPackageProject module installed from PS Gallery

• Runbuild.ps1 -Build -Clean
• Compiled module will be in./out/PSDesiredStateConfiguration

CI pipeline definition is in.vsts-ci\azure-pipelines-ci.yml and running Compliance and Pester tests intest\PSDesiredStateConfiguration.Tests.ps1 on Windows, Linux and Mac. CI builds are not signed.

The module is released on Powershell Gallery.For a release the code of this repo is mirrored into an internal repo and.vsts-ci\azure-pipelines-release.yml pipeline is run. Release builds are signed.

Please see ourCode of Conduct before participating in this project.

For any security issues, please see ourSecurity Policy.