Loading...
DSC v3 Microsoft Corporation
Use this command to install DSC v3:
winget install --id=Microsoft.DSC -e DSCv3 is the latest iteration of Microsoft's Desired State Configuration platform. DSCv3 is an open source command line application that abstracts the management of software components declaratively and idempotently. DSCv3 runs on Linux, macOS, and Windows without any external dependencies. With DSCv3, you can: - Author resources to manage your systems in any language - Invoke individual resources - Create configuration documents that define the desired state of a system
DSCv3 is an open-source command-line application designed for declarative and idempotent management of software components across Linux, macOS, and Windows systems without external dependencies.
Key Features:
- Multi-Language Resource Authoring: Define system configurations using any programming language.
- Resource Invocation: Execute individual resources to manage specific system states.
- Configuration Documents: Create JSON or YAML files that define the desired state of a system.
- Cross-Platform Support: Runs on Linux, macOS, and Windows with no reliance on PowerShell.
- Schema-Based Definitions: Use JSON schemas for resource definitions, configuration documents, and outputs.
- Backward Compatibility: Integrates with existing PowerShell DSC resources while maintaining compatibility with both Windows PowerShell and PowerShell Core.
Audience & Benefit:
Ideal for system administrators, DevOps engineers, and IT professionals seeking a flexible, scalable, and cross-platform solution to manage infrastructure configurations declaratively. By using DSCv3, users can ensure consistent system states across environments while leveraging any programming language for resource authoring.
Installable via winget, DSCv3 provides a modern approach to configuration management that aligns with contemporary DevOps practices.
README
DSCv3
> [!NOTE] > We welcome code contributions to this repository. For guidelines on how to contribute, > see our CONTRIBUTING.md. > Your feedback and participation help us improve DSCv3 for everyone.
What's DSCv3?
DSCv3 is the latest iteration of Microsoft's Desired State Configuration platform. DSCv3 is an open source command line application that abstracts the management of software components declaratively and idempotently. DSCv3 runs on Linux, macOS, and Windows without any external dependencies.
With DSCv3, you can:
- Author resources to manage your systems in any language
- Invoke individual resources
- Create configuration documents that define the desired state of a system
Differences from PowerShell DSC
DSCv3 differs from PowerShell DSC in a few important ways:
- DSCv3 doesn't depend on PowerShell. You can use DSCv3 without PowerShell installed and manage resources written in bash, python, C#, Go, or any other language.
- DSCv3 use of PowerShell based resources does not depend on PSDesiredStateConfiguration module
- DSCv3 doesn't include a local configuration manager. DSCv3 is invoked as a command. It doesn't run as a service.
- Non-PowerShell resources define their schemas with JSON files, not MOF files.
- Configuration documents are defined in JSON or YAML files, not PowerShell script files.
Importantly, while DSCv3 represents a major change to the DSC platform, DSCv3 is able to invoke PowerShell DSC Resources, including script-based and class-based DSC Resources, as they exist today. The configuration documents aren't compatible, but all published PowerShell DSC Resources are. You can use PowerShell DSC resources in DSCv3 with both Windows PowerShell and PowerShell.
Installing DSCv3
To install DSC v3:
- Download the latest release from this repository.
- Expand the release archive.
- Add the folder containing the expanded archive contents to the
PATH.
Explore DSCv3
If you're new to DSC or configuration management, we recommend reviewing the documentation.
Learning and authoring tutorials
If you're already familiar with DSC or just want to start experimenting with v3, we recommend reviewing the Samples repository and the accompanying . The Samples repo is ready to accept Pull Requests, which is a great way to contribute while v3 is in early phases of development.