<\/p>\n
This is the second post in a multi-part series about the new release of DSC.<\/em><\/p>\n Microsoft Desired State Configuration (DSC) v3.0.0<\/strong> is a modern, cross-platform configuration\nmanagement framework designed to help administrators and developers declaratively define and enforce\nsystem states. Whether you’re managing infrastructure, deploying applications, or automating system\nconfigurations, DSC provides a flexible and scalable approach to configuration as code.<\/p>\n <\/i>TIP<\/strong><\/p><\/p>\n This post uses the following terminology:<\/p>\n <\/div><\/p>\n To get started, follow these steps to install DSC on your system:<\/p>\n On Windows, you can install DSC from the Microsoft Store using On Linux and macOS, you can install DSC using the following steps:<\/p>\n The Run the following command to display the Use the command to get version information.<\/p>\n To learn more, see the The Use the following command to display a list of installed DSC resources.<\/p>\n When the command includes the adapter option, To learn more, see the The The following YAML configuration document calls the classic PowerShell resource To set a machine to the configuration, use the To learn more, see the Learn more about Authoring <\/a>Enhancements in <\/a>Desired State Configuration v3.0.0<\/a>.<\/p>\n For more information about DSC v3.0, see the DSCv3 documentation<\/a>. We value your feedback. Stop\nby our GitHub repository<\/a> and let us know of any issues you find.<\/p>\n Jason Helmick<\/p>\n Sr. Product Manager, PowerShell<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" This post show you how to install DSC v3.0.0 and get started using the **dsc** command.<\/p>\n","protected":false},"author":7527,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[3197],"class_list":["post-20703","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-powershell-dsc"],"acf":[],"blog_post_summary":" This post show you how to install DSC v3.0.0 and get started using the **dsc** command.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/20703","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/7527"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=20703"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/20703\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=20703"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=20703"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=20703"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
Installing DSC<\/h2>\n
winget<\/code>. By installing from the\nStore or using winget<\/code>, you get automatic updates for DSC.<\/p>\nwinget search DesiredStateConfiguration\r\nwinget install --id <insert-package-id> --source msstore<\/code><\/pre>\n\n
PATH<\/code> environment variable.<\/li>\n<\/ol>\nGetting started with the DSC command<\/h2>\n
dsc<\/code> command operates on a configuration document or invokes specific resources to manage\nsettings.<\/p>\ndsc<\/code> command help:<\/p>\ndsc --help<\/code><\/pre>\nApply configuration or invoke specific DSC resources\r\n\r\nUsage: dsc.exe [OPTIONS] <COMMAND>\r\n\r\nCommands:\r\n completer Generate a shell completion script\r\n config Apply a configuration document\r\n resource Invoke a specific DSC resource\r\n schema Get the JSON schema for a DSC type\r\n help Print this message or the help of the given subcommand(s)\r\n\r\nOptions:\r\n -l, --trace-level <TRACE_LEVEL> Trace level to use [possible values: error, warn, info, debug, trace]\r\n -t, --trace-format <TRACE_FORMAT> Trace format to use [default: default] [possible values: default, plaintext, json]\r\n -h, --help Print help\r\n -V, --version Print version<\/code><\/pre>\ndsc --version<\/code><\/pre>\ndsc 3.0.0<\/code><\/pre>\ndsc<\/code> command reference documentation<\/a>.<\/p>\nAccess DSC resources with
dsc resource<\/code><\/h3>\ndsc resource<\/code> command displays or invokes a specific DSC resource. The dsc resource<\/code> command\ncontains subcommands for listing DSC resources and invoking them directly.<\/p>\ndsc resource list<\/code><\/pre>\nType Kind Version Caps RequireAdapter Description\r\n----------------------------------------------------------------------------------------------------\r\nMicrosoft.DSC.Transitional\/RunCommandOnSet Resource 0.1.0 gs------ Takes a si\u2026\r\nMicrosoft.DSC\/Assertion Group 0.1.0 gs--t--- `test` wil\u2026\r\nMicrosoft.DSC\/Group Group 0.1.0 gs--t--- All resour\u2026\r\nMicrosoft.DSC\/PowerShell Adapter 0.1.0 gs--t-e- Resource a\u2026\r\nMicrosoft.Windows\/RebootPending Resource 0.1.0 g------- Returns in\u2026\r\nMicrosoft.Windows\/Registry Resource 0.1.0 gs-w-d-- Manage Win\u2026\r\nMicrosoft.Windows\/WMI Adapter 0.1.0 g------- Resource a\u2026\r\nMicrosoft.Windows\/WindowsPowerShell Adapter 0.1.0 gs--t--- Resource a\u2026<\/code><\/pre>\ndsc<\/code> checks for any resource adapters with a matching\nname. Classic PowerShell resources are part of the Microsoft.Windows\/WindowsPowerShell<\/code> adapter.<\/p>\ndsc resource list --adapter Microsoft.Windows\/WindowsPowerShell<\/code><\/pre>\nPartial listing\r\n\r\nType Kind Version Caps RequireAdapter\r\n----------------------------------------------------------------------------------------------------\r\nPSDesiredStateConfiguration\/Archive Resource 1.1 gs--t--- Microsoft.Windo\u2026\r\nPSDesiredStateConfiguration\/Environment Resource 1.1 gs--t--- Microsoft.Windo\u2026\r\nPSDesiredStateConfiguration\/File Resource 1.0.0 gs--t--- Microsoft.Windo\u2026\r\nPSDesiredStateConfiguration\/Group Resource 1.1 gs--t--- Microsoft.Windo\u2026\r\nPSDesiredStateConfiguration\/GroupSet Resource 1.1 gs--t--- Microsoft.Windo\u2026\r\nPSDesiredStateConfiguration\/Log Resource 1.1 gs--t--- Microsoft.Windo\u2026<\/code><\/pre>\ndsc<\/code> resource command reference documentation<\/a>.<\/p>\nManage a basic configuration<\/h3>\n
dsc config<\/code> command includes subcommands for managing the resource instances defined in a DSC\nconfiguration document.<\/p>\nWindowsFeature<\/code>\nfrom the PSDesiredStateConfiguration<\/strong> module to install a Windows web server (IIS) on Windows\nServer.<\/p>\n$schema: https:\/\/raw.githubusercontent.com\/PowerShell\/DSC\/main\/schemas\/2024\/04\/config\/document.json\r\nresources:\r\n - name: Use Windows PowerShell resources\r\n type: Microsoft.Windows\/WindowsPowerShell\r\n properties:\r\n resources:\r\n - name: Web server install\r\n type: PSDesiredStateConfiguration\/WindowsFeature\r\n properties:\r\n Name: Web-Server\r\n Ensure: Present<\/code><\/pre>\ndsc config set<\/code> subcommand. The following example\nshows how you can send the configuration document to DSCv3 using PowerShell:<\/p>\ndsc config get --file .\/web.comfig.dsc.yaml<\/code><\/pre>\ndsc config<\/code> command reference documentation<\/a>.<\/p>\nNext steps<\/h2>\n
Call to action<\/h2>\n