Central repository for PowerShell Desired State Configuration (DSC) resources.
PowerShell
Switch branches/tags
Nothing to show
Clone or download
johlju Update Test Guidelines with a localization section (#409)
- Update Test Guidelines with a localization section (issue #81).
Latest commit b400cdc Jul 14, 2018
Permalink
Failed to load latest commit information.
.github Update text around new resource module submission (#398) Jul 6, 2018
CommunityCalls Create notes.md Feb 12, 2018
DscResource.Template Update DscResource.Template (#411) Jul 6, 2018
DscResources Update all submodules Jun 13, 2018
Images Update documentation around the new CLA status check (#390) Jul 3, 2018
Tests.Template Changes to integration template (#416) Jul 8, 2018
xDscResources Update all submodules Jun 13, 2018
.gitmodules Remove duplicate submodules (#386) May 24, 2018
BestPractices.md Best Practices: Update documentation around localization (#403) Jun 11, 2018
CONTRIBUTING.md Update documentation around the new CLA status check (#390) Jul 3, 2018
CommunityAgenda.md Update CommunityAgenda.md Mar 22, 2018
GettingStartedWithGitHub.md Updated texts around abandoned PR's (#413) Jul 7, 2018
GettingStartedWithPester.md Updated GettingStartedWithPester (#400) Jun 27, 2018
HighQualityModuleGuidelines.md Update HighQualityModuleGuidelines.md Apr 26, 2018
LICENSE Updating year in LICENSE file (#396) Jun 13, 2018
Maintainers.md Updated texts around abandoned PR's (#413) Jul 7, 2018
Naming.md Updating repo guidelines (#317) Dec 6, 2017
NewResourceModuleSubmissions.md Update text around new resource module submission (#398) Jul 6, 2018
PSSARuleSeverities.md Made minor spelling updates (#302) Aug 16, 2017
README.md Update README.md (#397) Jun 1, 2018
StyleGuidelines.md Added Correct Format for Keywords rule to StyleGuidelines.md - Fixes #… Jul 8, 2018
Supportability.md Updating repo guidelines (#317) Dec 6, 2017
TestsGuidelines.md Update Test Guidelines with a localization section (#409) Jul 14, 2018

README.md

DSC Resources

Join the chat at https://gitter.im/PowerShell/DscResources

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

A dashboard of all open issues and pull requests across DSC Resource Kit is available on the DSC Resource Kit Waffle board.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Support

Please review the DSC Resource Kit support guidelines here.

New to PowerShell DSC

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

Resource Module Source Code

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 the xDscResources folder or DscResources folder. Read about the differences in naming under the High Quality Resource Module section.

To download the released source code for all DSC resource modules, clone this repository with this git command:

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

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

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

Released DSC Resource Modules

To see a list of all released DSC Resource Kit modules, go to the PowerShell Gallery and display all modules tagged as DSCResourceKit.

To find a specific module, enter the module's name in the search box in the upper 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 PowerShell prompt and use this command:

Update-Module

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

Get-DscResource

Contributing to the Resource Modules

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 or modules, add test automation, improve documentation, fix existing issues, or open new ones. See our contributing guide for more info on how to become a DSC Resource Kit contributor.

Resource Module Maintainers

To see a list of the maintainers for each resource modules as well as the instructions for maintaining a module, see our guidelines for DSC resource maintainers.

Questions, Comments, Concerns?

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

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 our community agenda.