{"id":1971,"date":"2013-11-19T14:56:00","date_gmt":"2013-11-19T14:56:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2013\/11\/19\/resource-designer-tool-a-walkthrough-writing-a-dsc-resource\/"},"modified":"2022-11-09T09:46:39","modified_gmt":"2022-11-09T17:46:39","slug":"resource-designer-tool-a-walkthrough-writing-a-dsc-resource","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/resource-designer-tool-a-walkthrough-writing-a-dsc-resource\/","title":{"rendered":"Resource Designer Tool \u2013 A walkthrough writing a DSC resource"},"content":{"rendered":"

At the heart of Windows PowerShell Desired State Configuration are the resources. It is the resources which act behind the scenes for DSC to achieve its \u201cmake it so\u201d philosophy. DSC ships with a number of resources in-box and you can take a look here<\/a> for the complete list. However, once you get started with DSC, you may want to write your own resources (which are PowerShell modules) for your particular use case. This post will walk you through creating a custom DSC resource. You can take a look here<\/a> to get an understanding of the schema\/packaging of DSC resources. Attached with this post is the Resource Designer Tool which makes writing resources a breeze.<\/p>\n

There are certain rules which must be complied with when writing a DSC resource. I will state the rules towards the end of the post for reference and completeness. The Resource Designer Tool takes care of the nitty-gritty so that you can concentrate on implementing the features in your resource without having to get caught up in figuring out the correct MOF syntax or worrying about missing some important requirements in the resources (which is a PowerShell module) file.<\/p>\n

Let us take an example. Say you want to create a resource for modelling an Active Directory User. (The User resource shipped in-box is for local users only.) In this example, we will have the following configuration properties in our schema MOF:<\/p>\n

\n