How to create a DSC configuration

There are two ways to create a DSC configuration (Learn more about the Desired State Configuration (DSC))

  • use our DSC Configuration Wizard
  • create your configuration locally

DSC Configuration Wizard

To use the DSC Configuration Wizard select Create configuration.

Create new configuration

Now you have two options:

  • add resources with DSC modules or
  • use Group Policies.

For our first resource we use Add Resources.

Add resources in DSC Configuration Wizard

The selected module is the PSDesiredStateConfiguration in Version 1.1 and the Registry resource. Enter your values as desired and save it.

DSC resource

After saving you may navigate to the MyExampleRegistry resource to see the parameters you have set.

Added DSC resource

To add a second resource we will use Group Policies. If you are used to configure Group Policies you will probably recognize some similarity.

Simply select the Group Polic Object (GPO) you want to enable and save it with a click on Close.

GPO

Now you see your created resources. The GPO is nothing more than a registry entry in the \SOFTWARE\Policies path.

Resources

Save your DSC configuration. Optionally you can enter a useful description for your colleagues and set it to active.

Save DSC Configuration

Create your configuration locally

We wrote a detailed instruction on how to write DSC configurations.

We recommend to use a code editor such as Visual Studio Code or IntelliJ IDEA. Find out more here: Configuration Management - Get Started.

However if you are already into writing DSC configurations yourself or simply want to manage them by yourself you can always upload your locally created configurations either compiled as .mof or .ps1 into XOAP.

Click on Add Configuration.

Add configuration

Browse to the location where your configuration resides and click on Save.

Upload a configuration