Repository files navigation

This is the central repository for the DSC Resource Kit, a collection of DSCresources maintained and released by Microsoft.

A dashboard of all open issues and pull requests across DSC Resource Kit isavailable on theDSC Resource Kit GitHub Project board.

This project has adopted theMicrosoft Open Source Code of Conduct.For more information see theCode of Conduct FAQor contactopencode@microsoft.com with any additionalquestions or comments.

Please review the DSC Resource Kit support guidelineshere.

Desired State Configuration (DSC) is a declarative management platform in PowerShellto configure, deploy, and manage systems.If you are new to DSC, configurations, or resources, you can learn more aboutthemhere.

The DSC Resource Kit currently contains more than 55 different resource modules.

You can find the source code of a resource module by visiting its GitHub page at:

https://github.com/PowerShell/< module name >

For example, for the CertificateDsc module, go to:

https://github.com/PowerShell/CertificateDsc

All DSC resource modules are also listed as submodules of this repository (DscResources)in thexDscResources folderorDscResources folder.Read about the differences in naming under theHigh Quality Resource Modulesection.

To download the released source code forall DSC resource modules, clone thisrepository with this git command:

git clone https://github.com/PowerShell/DscResources.git --recursive

Alternatively, to download just the documentation provided in this repository, clonethis repository with this git command:

git clone https://github.com/PowerShell/DscResources.git

To see a list ofall released DSC Resource Kit modules, go to thePowerShell Gallery and displayall modules tagged as DSCResourceKit.

To find aspecific module, enter the module's name in the search box in theupper right corner of the PowerShell Gallery or go directly to its URL:http://www.powershellgallery.com/packages/< module name >For example:http://www.powershellgallery.com/packages/xWebAdministration

We recommend that you use PowerShellGet to install DSC resource modules:

Install-Module-Name< module name>

For example:

Install-Module-Name xWebAdministration

To update all previously installed modules at once, open an elevated PowerShellprompt and use this command:

Update-Module

After installing modules, you can discover all DSC resources available to yourlocal system with this command:

Get-DscResource

You are more than welcome to contribute to the development of the DSC Resource Kit.There are several different ways you can help. You can create new DSC resources ormodules, add test automation, improve documentation, fix existing issues, or opennew ones.See ourcontributing guidefor more info on how to become a DSC Resource Kit contributor.

To see a list of the maintainers for each resource modules as well as the instructionsfor maintaining a module, see ourguidelines for DSC resource maintainers.

If you're looking into using PowerShell DSC, have questions or issues with a currentresource, or would like a new resource, let us know on Twitter (@PowerShell_Team)or by creating an issue onGitHub.

The PowerShell team also hosts DSC Resource Kit community calls to give updates,collect feedback, and answer questions. Find the date of the next call in ourcommunity agenda.