Training
Module
Implement Desired State Configuration (DSC) - Training
Implement Desired State Configuration (DSC)
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Microsoft's Desired State Configuration (DSC) is a declarative configuration platform. With DSC, the state of a machine is described using a format that should be clear to understand even if the reader isn't a subject matter expert. Unlike imperative tools, with DSC the definition of an application environment is separate from the script logic that implements how it's delivered.
The DSCv3 command line application abstracts the management of software components declaratively and idempotently. DSCv3 runs on Linux, macOS, and Windows without any external dependencies.
With DSCv3, you can:
DSC Configuration Documents are declarative YAML files that define instances of resources. Typically, configuration documents define what state to enforce.
Example scenarios include requirements for an application environment or operational/security standards.
DSC Resources define how to manage state for a particular system or application component. Resources describe a schema for the manageable settings of the component. Every resource can be used with the Get and Test operations to retrieve the current state of a resource instance and validate whether it's in the desired state. Most resources also support enforcing the desired state with the Set operation.
Example scenarios include how to update the contents of a file, how to run a utility that changes the state of a machine, or how to configure settings of an application.
DSCv3 leverages the PSDesiredStateConfiguration module to support compatibility with existing PowerShell based resources.
DSCv3 differs from PowerShell Desired State Configuration (PSDSC) in a few important ways:
Importantly, while DSCv3 represents a major change to the DSC platform, DSCv3 is able to invoke PSDSC Resources, including script-based and class-based DSC Resources, as they exist today. The configuration documents aren't compatible, but all published PSDSC Resources are. You can use PSDSC resources in DSCv3 with both Windows PowerShell and PowerShell.
To install DSCv3:
PATH
.To install the PSDesiredStateConfiguration
version 3 beta from the PowerShell Gallery:
# Using PSResourceGet
Install-PSResource -Name PSDesiredStateConfiguration -Version 3.0.0-beta1 -Prerelease
# Using PowerShellGet
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 3.0.0-beta1 -AllowPrerelease
DSCv3 is a platform tool that abstracts the concerns for defining and invoking resources. Higher order tools, like Azure Machine Configuration, Azure Automanaged VM, and WinGet are early partners for DSCv3 as orchestration agents.
DSCv3 uses JSON schemas to define the structure of resources, configuration documents, and the outputs that DSCv3 returns. These schemas make it easier to integrate DSCv3 with other tools, because they standardize and document how to interface with DSCv3.
DSC feedback
DSC is an open source project. Select a link to provide feedback:
Training
Module
Implement Desired State Configuration (DSC) - Training
Implement Desired State Configuration (DSC)