{"id":1831,"date":"2014-02-07T15:54:00","date_gmt":"2014-02-07T15:54:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2014\/02\/07\/need-more-dsc-resources-announcing-dsc-resource-kit-wave-2\/"},"modified":"2024-02-22T12:58:09","modified_gmt":"2024-02-22T20:58:09","slug":"need-more-dsc-resources-announcing-dsc-resource-kit-wave-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/need-more-dsc-resources-announcing-dsc-resource-kit-wave-2\/","title":{"rendered":"Need more DSC Resources? Announcing DSC Resource Kit Wave 2"},"content":{"rendered":"

Good news everyone! Starting today, you can use Windows PowerShell Desired State Configuration (DSC) <\/strong>to configure Active Directory <\/strong>and SQL Server (including High Availability Groups)<\/strong>. We are pleased to release the next wave of the DSC Resource Kit \u2013 one that enables you to start using DSC to solve your real world problems and scenarios.<\/p>\n

When we shipped DSC in Windows Server 2012 R2, we shipped a platform with great infrastructure for configuration. \u00a0The next step for any platform like DSC is the creation of resources to make it immediately usable in significant real world scenarios.\u00a0 With the resources we shipped in box, configuring SQL Server was out of reach for most of our customers.<\/em>\u00a0 That’s changing today.\u00a0 Now is the time to create a vibrant ecosystem and expansive community.<\/p>\n

Over the past few months, we’ve worked hard to kick start this community.\u00a0 Last month, we released the first wave of the DSC Resource Kit<\/a>.\u00a0 That release contained six experimental DSC resources, enabling you to configure IIS websites<\/strong> and Hyper-V<\/strong>.\u00a0 Those were a limited subset of resources \u2013 a first pass at the process.\u00a0 Now, we\u2019re ready to turn it up a notch.<\/p>\n

This wave of the DSC Resource Kit includes fourteen new resources<\/strong>.\u00a0 These resources are all focused on enabling you to configure Active Directory<\/strong> and SQL Server<\/strong> (including High Availability Groups).\u00a0 These are real world scenarios where DSC can<\/em> make an impact.\u00a0 Soon, we\u00a0will be\u00a0blogging an involved example that uses these resources to set up a SQL High Availability Group<\/strong> using DSC.\u00a0 In addition, we\u2019ve updated many of the resources from the initial release, adding features and fixing bugs.<\/p>\n

Click here to see the latest DSC Resource Kit modules.<\/a><\/span><\/p>\n

We hope these resources will be a starting point for the DSC community \u2013 something to facilitate DSC resource creation.\u00a0 Feel free to take and modify these resources to meet your needs <\/strong>(while following the Renaming Guidelines).<\/strong> We were thrilled to see that several community members created modified versions of last wave\u2019s resources in PowerShell.Org\u2019s GitHub repository<\/a>.\u00a0 Also, don\u2019t forget that you can create your own resources \u2013 for help, check out this blog post<\/a> and the DSC Resource Designer<\/a>.<\/p>\n

On a more serious note, we must reiterate that these resources come without any guarantees.\u00a0 The \u201cx\u201d prefix stands for experimental \u2013 which means these resources are provided AS IS and are not supported through any Microsoft support program or service. We will monitor the TechNet pages, take feedback, and may provide fixes on a \u201cfix forward\u201d basis.<\/p>\n

Finally \u2013 before diving into the details \u2013 we want to invite everyone to give feedback on the DSC Resource Kit.\u00a0 Are you hungry for even more resources?\u00a0 Do you need DSC to enable any important scenarios?\u00a0 Let us know through the comments or TechNet Q&A — there’s definitely more to come.<\/p>\n

Description of Resources<\/h2>\n

After installing the modules, you can discover all of the resources available through the Get-DSCResource cmdlet:<\/p>\n

\"Image<\/a><\/p>\n

Here is a brief description of each resource (for more details on a resource, check out the TechNet pages).<\/p>\n

 <\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Resource<\/strong><\/span><\/td>\nDescription<\/strong><\/span><\/td>\nModule Name<\/strong><\/span><\/td>\nLink<\/strong><\/span><\/td>\n<\/tr>\n
xADDomain<\/td>\nCreate and manage an Active Directory Domain<\/td>\nxActiveDirectory<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xADDomainController<\/td>\nCreate and manage an AD Domain Controller<\/td>\nxActiveDirectory<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xADUser<\/td>\nCreate and manage an AD User<\/td>\nxActiveDirectory<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xWaitForADDomain<\/td>\nPause configuration implementation until the AD Domain is available.\u00a0 Used for cross machine synchronization.<\/td>\nxActiveDirectory<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xSqlServerInstall<\/td>\nCreate and manage a SQL Server Installation.<\/td>\nxSqlps<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xSqlHAService<\/td>\nCreate and manage a SQL High Availability Service.<\/td>\nxSqlps<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xSqlHAEndpoint<\/td>\nCreate and manage the endpoint used to access a SQL High Availability Group.<\/td>\nxSqlps<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xSqlHAGroup<\/td>\nCreate and manage a SQL High Availability Group.<\/td>\nxSqlps<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xWaitForSqlHAGroup<\/td>\nPause configuration implementation until a SQL HA Group is available.\u00a0 Used for cross machine synchronization.<\/td>\nxSqlps<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xCluster<\/td>\nCreate and manage a cluster.<\/td>\nxFailOverCluster<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xWaitForCluster<\/td>\nPause configuration until a cluster is available.\u00a0 Used for cross machine synchronization.<\/td>\nxFailOverCluster<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xSmbShare<\/td>\nCreate and manage a SMB Share.<\/td>\nxSmbShare<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xFirewall<\/td>\nCreate and manage Firewall rules<\/td>\nxNetworking<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xVhdFile<\/td>\nManage files to be copied into a Vhd.<\/td>\nxHyper-V<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xWebsite<\/td>\nAdded functionality to xWebsite to support configuration of https websites.<\/td>\nxWebAdministration<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n
xVhd<\/td>\nBug fixes<\/td>\nxHyper-V<\/td>\n\u00a0click here<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Renaming Guidelines<\/h2>\n

When making changes to these resources, we urge the following practice:<\/p>\n

1.\u00a0\u00a0\u00a0\u00a0 Update the following names by replacing MSFT with your company\/community name and replacing the \u201cx\u201d with “c” (short for “Community”) or another prefix of your choice:<\/p>\n

a.\u00a0\u00a0\u00a0\u00a0 Module name (ex: xWebAdministration becomes cWebAdministration)<\/p>\n

a.\u00a0\u00a0\u00a0\u00a0 Folder name (ex: MSFT_xWebsite becomes Contoso_cWebsite)<\/p>\n

b.\u00a0\u00a0\u00a0\u00a0 Resource Name (ex: MSFT_xWebsite becomes Contoso_cWebsite)<\/p>\n

c.\u00a0\u00a0\u00a0\u00a0 Resource Friendly Name (ex: xWebsite becomes cWebsite)<\/p>\n

d.\u00a0\u00a0\u00a0\u00a0 MOF class name (ex: MSFT_xWebsite becomes Contoso_cWebsite)<\/p>\n

e.\u00a0\u00a0\u00a0\u00a0 Filename for the <resource>.schema.mof (ex: MSFT_xWebsite.schema.mof becomes Contoso_cWebsite.schema.mof)<\/p>\n

2.\u00a0\u00a0\u00a0\u00a0 Update module and metadata information in the module manifest<\/p>\n

3.\u00a0\u00a0\u00a0\u00a0 Update any configuration that use these resources<\/p>\n

 <\/p>\n

We reserve resource and module names without prefixes (“x” or “c”) for future use (e.g. “MSFT_WebAdministration” or “Website”).\u00a0 If the next version of Windows Server ships with a “Website” resource, we don’t want to break any configurations that use any community modifications.\u00a0 Please keep a prefix such as “c” on all community modifications. <\/em><\/p>\n

As specified in the license, you may copy or modify this resource as long as they are used on the Windows Platform. <\/em><\/p>\n

Requirements<\/h2>\n

The DSC Resource Kit requires Windows 8.1 or Windows Server 2012 R2 with update KB2883200<\/a> (aka the GA Update Rollup). You can check whether it is installed by running the following command:<\/p>\n

 <\/p>\n

PS C:\\WINDOWS\\system32> Get-HotFix -Id KB2883200<\/span><\/p>\n

\u00a0<\/span><\/p>\n

Source\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Description\u00a0\u00a0\u00a0\u00a0\u00a0 HotFixID\u00a0 \u00a0\u00a0\u00a0\u00a0InstalledBy\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 InstalledOn\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/p>\n

——\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ———–\u00a0\u00a0\u00a0\u00a0\u00a0 ——–\u00a0\u00a0\u00a0\u00a0\u00a0 ———–\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ———–\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/p>\n

NANA-TOUCH\u00a0\u00a0\u00a0 Update\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 KB2883200\u00a0\u00a0\u00a0\u00a0 NANA-TOUCH\\Admini… 9\/30\/2013 12:00:00 AM\u00a0\u00a0\u00a0 <\/span><\/p>\n

\u00a0<\/span><\/p>\n

On supported down level operating systems, they require WMF 4.0. Refer to these previous blog posts for more information on WMF 4.0<\/a> and issues with partial installation<\/a>.<\/p>\n

Using Resources<\/h2>\n

For simple examples of configurations that use these resources, check out the\u00a0respective\u00a0TechNet pages.\u00a0Soon, we\u00a0will be\u00a0blogging an involved example that details the configuration of a\u00a0SQL High Availability Group<\/strong> using DSC. If you need help deploying the resources, see this blog post<\/a>.<\/p>\n

 <\/p>\n

Thanks,<\/p>\n

 <\/p>\n

John Slack<\/p>\n

Program Manager<\/p>\n

PowerShell Team<\/p>\n","protected":false},"excerpt":{"rendered":"

Good news everyone! Starting today, you can use Windows PowerShell Desired State Configuration (DSC) to configure Active Directory and SQL Server (including High Availability Groups). We are pleased to release the next wave of the DSC Resource Kit \u2013 one that enables you to start using DSC to solve your real world problems and scenarios. […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[142,150,248,251,345,348],"class_list":["post-1831","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-desired-state-configuration","tag-dsc","tag-powershell","tag-powershell-4-0","tag-windows-powershell-4-0","tag-windows-powershell-desired-state-configuration"],"acf":[],"blog_post_summary":"

Good news everyone! Starting today, you can use Windows PowerShell Desired State Configuration (DSC) to configure Active Directory and SQL Server (including High Availability Groups). We are pleased to release the next wave of the DSC Resource Kit \u2013 one that enables you to start using DSC to solve your real world problems and scenarios. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/1831","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\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=1831"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/1831\/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=1831"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=1831"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=1831"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}