dsc command

November 7, 2025 · View on GitHub

The dsc command provides access to Microsoft DSC (Desired State Configuration) resource operations. Use this command to get, set, test, and export resource states from the command line.

Syntax

wingetstudio dsc <operation> [options]

Operations

The dsc command supports the following resource operations:

Operation	Description
`get`	Retrieve the current state of a resource
`set`	Configure a resource to match desired state
`test`	Test whether a resource is in desired state
`export`	Export all instances of a resource
`schema`	Display the JSON schema for a resource
`manifest`	Display the resource manifest

Options

Option	Description
`-?, -h, --help`	Show help and usage information

Available resources

The following DSC resources are provided by WinGet Studio:

Resource	Type	Operations	Reference
`settings`	`Microsoft.WinGetStudio/Settings`	get, set, test, export, schema, manifest	Settings

Examples

Get resource state

Retrieve the current state of the Settings resource:

wingetstudio dsc get --resource settings

Output:

{
  "settings": {
    "theme": "Default",
    "telemetry": {
      "disable": false
    }
  }
}

Set resource state

Configure the Settings resource with desired state:

wingetstudio dsc set --resource settings --input '{
  "settings": {
    "theme": "Dark",
    "telemetry": {
      "disable": true
    }
  }
}'

Output:

{
  "settings": {
    "theme": "Dark",
    "telemetry": {
      "disable": true
    }
  }
}

Test resource state

Test whether the Settings resource is in desired state:

wingetstudio dsc test --resource settings --input '{
  "settings": {
    "theme": "Dark",
    "telemetry": {
      "disable": false
    }
  }
}'

Output:

{
  "settings": {
    "theme": "Dark",
    "telemetry": {
      "disable": true
    }
  },
  "_inDesiredState": false
}

The _inDesiredState property indicates whether the current state matches the desired state.

Export resource configuration

Export all instances of the Settings resource:

wingetstudio dsc export --resource settings

Output:

{
  "settings": {
    "theme": "Default",
    "telemetry": {
      "disable": false
    }
  }
}

Display resource schema

View the JSON schema for the Settings resource:

wingetstudio dsc schema --resource settings

Returns the complete JSON schema defining the resource's properties and structure.

Display resource manifest

View the resource manifest:

wingetstudio dsc manifest --resource settings

Returns the DSC resource manifest including supported operations and adapter information.