Windows PowerShell Desired State Configuration (DSC) provides a configuration platform built into Windows that is based on open standards. DSC is flexible enough to function reliably and consistently in each stage of the deployment lifecycle (development, test, pre-production, production), as well as during scale-out, which is required in the cloud world.
To learn more about Windows PowerShell Desired State Configuration, check out the blog posts on the PowerShell Blog (this is a good starting point). There are also great community resources, such as PowerShell.org, or PowerShell Magazine.
If you would like to use DSC on Linux, there is a step by step guide available on the Building Clouds Blog and the source is available in the Microsoft OpenTech repo.
This is the central repository for PowerShell Desired State Configuration (DSC) resources. DSC resources are packaged in PowerShell modules, along with tests, documentation, and examples, each in their own GitHub repositories. These repositories are included as submodules of the DscResources repository you're currently browsing.
You can clone this repository to download the source for all DSC resource modules
git clone --recursive https://github.com/PowerShell/DscResources.git
Or just download the respository's structure and documentation
git clone https://github.com/PowerShell/DscResources.git
To see a list of all released DSC Resource Kit modules, go to the PowerShell Gallery and display all modules tagged as DSCResourceKit. You can also type a module’s name in the search box on the upper right side of the PowerShell Gallery to find a specific module.
Another way is to go directly to a specific module by typing it’s URL:
http://www.powershellgallery.com/packages/MODULE_NAME
e.g.:
http://www.powershellgallery.com/packages/xWebAdministration
Of course, you can always use PowerShellGet (available in WMF 5.0) as well:
Find-DscResource
Nuget feeds with development builds (created every time we merge PR/push commit) are available for all our modules under:
https://ci.appveyor.com/nuget/MODULE_NAME
e.g.:
https://ci.appveyor.com/nuget/xpsdesiredstateconfiguration
To list all available versions of xPSDesiredStateConfiguration module:
nuget.exe list -source https://ci.appveyor.com/nuget/xpsdesiredstateconfiguration -allversions
To install most recent version of xPSDesiredStateConfiguration:
nuget.exe install xpsdesiredstateconfiguration -source https://ci.appveyor.com/nuget/xpsdesiredstateconfiguration -outputdirectory C:\nuget
To install specific version (here: 3.4.0.86) of xPSDesiredStateConfiguration:
nuget.exe install xpsdesiredstateconfiguration -source https://ci.appveyor.com/nuget/xpsdesiredstateconfiguration -outputdirectory C:\nuget -version 3.4.0.86
If you've found a bug in a particular DSC module, or you have a suggestion for how to improve it, submit an issue in the module's repository.
Learn more about writing useful bug reports.
See our contribution guidelines.
See our guidelines for DSC resource maintainers.
You can see dashboard of all open issues and pull requests acrross DSC Resource here:
