{"id":13135,"date":"2017-03-08T16:31:30","date_gmt":"2017-03-09T00:31:30","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/?p=13135"},"modified":"2019-02-18T12:38:02","modified_gmt":"2019-02-18T19:38:02","slug":"dsc-resource-kit-release-march-2017","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/dsc-resource-kit-release-march-2017\/","title":{"rendered":"DSC Resource Kit Release March 2017"},"content":{"rendered":"<div class=\"markdown-body\">\n<p>We just released the DSC Resource Kit!<\/p>\n<p>This release includes updates to <strong>10 DSC resource modules<\/strong>, including <strong>19 new DSC resources<\/strong>. In these past 6 weeks, <strong>155 pull requests (the most ever!)<\/strong> have been merged and <strong>71 issues<\/strong> have been closed, all thanks to our amazing community!<\/p>\n<p>A few weeks ago we also released a new DSC resource module called SecurityPolicyDsc with resources to configure local security policies through secedit. Thank you to Jason Walker for this great new module!<\/p>\n<p>The modules updated in this release are:<\/p>\n<ul>\n<li>OfficeOnlineServerDsc<\/li>\n<li>PSDscResources<\/li>\n<li>SecurityPolicyDsc<\/li>\n<li>SharePointDsc<\/li>\n<li>xCertificate<\/li>\n<li>xExchange<\/li>\n<li>xPSDesiredStateConfiguration<\/li>\n<li>xRemoteDesktopSessionHost<\/li>\n<li>xSQLServer<\/li>\n<li>xWindowsUpdate<\/li>\n<\/ul>\n<p>For a detailed list of the resource modules and fixes in this release, see the Included in this Release section below.<\/p>\n<p>Our last <strong>community call<\/strong> for the DSC Resource Kit was last week on March 1. A <a href=\"https:\/\/youtu.be\/QVsuNzFZAPo\">recording<\/a> of our updates as well as <a href=\"https:\/\/github.com\/powershell\/\">summarizing notes<\/a> are available. Join us next time at 9AM PST on April 12 to ask questions and give feedback about your experience with the DSC Resource Kit. Keep an eye on the <a href=\"https:\/\/github.com\/PowerShell\/DscResources\/blob\/master\/CommunityAgenda.md\">community agenda<\/a> for the link to the call.<\/p>\n<p>We strongly encourage you to update to the newest version of all modules using the PowerShell Gallery, and don&#8217;t forget to give us your feedback in the comments below, on GitHub, or on Twitter (<a href=\"https:\/\/twitter.com\/PowerShell_Team\">@PowerShell_Team<\/a>)!<\/p>\n<p>All resources with the &#8216;x&#8217; prefix in their names are still experimental &#8211; this means that those resources are provided AS IS and are not supported through any Microsoft support program or service. If you find a problem with a resource, please <a href=\"https:\/\/github.com\/PowerShell\/DscResources\/blob\/master\/CONTRIBUTING.md#submitting-an-issue\">file an issue<\/a> on GitHub.<\/p>\n<h2>Included in this Release<\/h2>\n<p>You can see a detailed summary of all changes included in this release in the table below. For past release notes, go to the README.md or Changelog.md file on the GitHub repository page for a specific module (see the How to Find DSC Resource Modules on GitHub section below for details on finding the GitHub page for a specific module).<\/p>\n<table>\n<thead>\n<tr>\n<th>Module Name<\/th>\n<th>Version<\/th>\n<th>Release Notes<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>OfficeOnlineServerDsc<\/td>\n<td>1.0.0.0<\/td>\n<td>\n<ul>\n<li>Added documentation to the module to finalise for release<\/li>\n<li>Renamed resources to shorten names before release\n<ul>\n<li>&#8220;OfficeOnlineServerWebAppsFarm&#8221; becomes &#8220;OfficeOnlineServerFarm&#8221;<\/li>\n<li>&#8220;OfficeOnlineServerWebAppsMachine&#8221; becomes &#8220;OfficeOnlineServerMachine&#8221;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>PSDscResources<\/td>\n<td>2.5.0.0<\/td>\n<td>\n<ul>\n<li>Enable codecov.io code coverage reporting<\/li>\n<li>Group\n<ul>\n<li>Added support for domain based group members on Nano server.<\/li>\n<\/ul>\n<\/li>\n<li>Added the Archive resource<\/li>\n<li>Update Test-IsNanoServer cmdlet to properly test for a Nano server rather than the core version of PowerShell<\/li>\n<li>Registry\n<ul>\n<li>Fixed bug where an error was thrown when running Get-DscConfiguration if the registry already existed<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>SecurityPolicyDsc<\/td>\n<td>1.2.0.0<\/td>\n<td>\n<ul>\n<li>SecurityTemplate: Remove [ValidateNotNullOrEmpty()] attribute for IsSingleInstance parameter<\/li>\n<li>Fixed typos<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>SharePointDsc<\/td>\n<td>1.6.0.0<\/td>\n<td>\n<ul>\n<ul>\n<li>Updated SPWebApplication to allow Claims Authentication configuration<\/li>\n<li>Updated documentation in regards to guidance on installing binaries from<\/li>\n<\/ul>\n<\/ul>\n<p>network locations instead of locally<\/p>\n<ul>\n<li>New resources: SPFarmPropertyBag<\/li>\n<li>Bugfix in SPSite, which wasnt returing the quota template name in a correct way<\/li>\n<li>Bugfix in SPAppManagementServiceApp which wasnt returning the correct database<\/li>\n<\/ul>\n<p>name<\/p>\n<ul>\n<li>Bugfix in SPAccessServiceApp which did not return the database server<\/li>\n<li>Bugfix in SPDesignerSettings which filtered site collections with an incorrect<\/li>\n<\/ul>\n<p>parameter<\/p>\n<ul>\n<li>Updated the parameters in SPFarmSolution to use the full namespace<\/li>\n<li>Bugfix in SPFarmsolution where it returned non declared parameters<\/li>\n<li>Corrected typo in parameter name in Get method of SPFeature<\/li>\n<li>Added check in SPHealAnalyzerRuleState for incorrect default rule schedule of<\/li>\n<\/ul>\n<p>one rule<\/p>\n<ul>\n<li>Improved check for CloudSSA in SPSearchServiceApp<\/li>\n<li>Bugfix in SPSearchServiceApp in which the database and dbserver were not<\/li>\n<\/ul>\n<p>returned correctly<\/p>\n<ul>\n<li>Improved runtime of SPSearchTopology by streamlining wait processes<\/li>\n<li>Fixed bug with SPSearchServiceApp that would throw an error about SDDL string<\/li>\n<li>Improved output of test results for AppVeyor and VS Code based test runs<\/li>\n<li>Fixed issue with SPWebAppPolicy if OS language is not En-Us<\/li>\n<li>Added SPFarm resource, set SPCreateFarm and SPJoinFarm as deprecated to be<\/li>\n<\/ul>\n<p>removed in version 2.0<\/td>\n<\/tr>\n<tr>\n<td>xCertificate<\/td>\n<td>2.4.0.0<\/td>\n<td>\n<ul>\n<li>Converted AppVeyor build process to use AppVeyor.psm1.<\/li>\n<li>Correct Param block to meet guidelines.<\/li>\n<li>Moved shared modules into modules folder.<\/li>\n<li>xCertificateExport:\n<ul>\n<li>Added new resource.<\/li>\n<\/ul>\n<\/li>\n<li>Cleanup xCertificate.psd1 to remove unneccessary properties.<\/li>\n<li>Converted AppVeyor.yml to use DSCResource.tests shared code.<\/li>\n<li>Opted-In to markdown rule validation.<\/li>\n<li>Examples modified to meet standards for auto documentation generation.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>xExchange<\/td>\n<td>1.14.0.0<\/td>\n<td>\n<ul>\n<li>xExchDatabaseAvailabilityGroup: Added parameter AutoDagAutoRedistributeEnabled,PreferenceMoveFrequency<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>xPSDesiredStateConfiguration<\/td>\n<td>6.1.0.0<\/td>\n<td>\n<ul>\n<li>Moved DSC pull server setup tests to DSCPullServerSetup folder for new common tests<\/li>\n<li>xArchive:\n<ul>\n<li>Updated the resource to be a high quality resource<\/li>\n<li>Transferred the existing &#8220;unit&#8221; tests to integration tests<\/li>\n<li>Added unit and end-to-end tests<\/li>\n<li>Updated documentation and examples<\/li>\n<\/ul>\n<\/li>\n<li>xUser\n<ul>\n<li>Fixed error handling in xUser<\/li>\n<\/ul>\n<\/li>\n<li>xRegistry\n<ul>\n<li>Fixed bug where an error was thrown when running Get-DscConfiguration if the registry key already existed<\/li>\n<\/ul>\n<\/li>\n<li>Updated Test-IsNanoServer cmdlet to properly test for a Nano server rather than the core version of PowerShell<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>xRemoteDesktopSessionHost<\/td>\n<td>1.4.0.0<\/td>\n<td>\n<ul>\n<li>Updated CollectionName parameter to validate length between 1 and 15 characters, and added tests to verify.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>xSqlServer<\/td>\n<td>6.0.0.0<\/td>\n<td>\n<ul>\n<li>Changes to xSQLServerConfiguration\n<ul>\n<li>BREAKING CHANGE: The parameter SQLInstanceName is now mandatory.<\/li>\n<li>Resource can now be used to define the configuration of two or more different DB instances on the same server.<\/li>\n<\/ul>\n<\/li>\n<li>Changes to xSQLServerRole\n<ul>\n<li>xSQLServerRole now correctly reports that the desired state is present when the login is already a member of the server roles.<\/li>\n<\/ul>\n<\/li>\n<li>Added new resources\n<ul>\n<li>xSQLServerAlwaysOnAvailabilityGroup<\/li>\n<\/ul>\n<\/li>\n<li>Changes to xSQLServerSetup\n<ul>\n<li>Properly checks for use of SQLSysAdminAccounts parameter in $PSBoundParameters. The test now also properly evaluates the setup argument for SQLSysAdminAccounts.<\/li>\n<li>xSQLServerSetup should now function correctly for the InstallFailoverCluster action, and also supports cluster shared volumes. Note that the AddNode action is not currently working.<\/li>\n<li>It now detects that feature Client Connectivity Tools (CONN) and Client Connectivity Backwards Compatibility Tools (BC) is installed.<\/li>\n<li>Now it can correctly determine the right cluster when only parameter InstallSQLDataDir is assigned a path (issue 401).<\/li>\n<li>Now the only mandatory path parameter is InstallSQLDataDir when installing Database Engine (issue 400).<\/li>\n<li>It now can handle mandatory parameters, and are not using wildcards to find the variables containing paths (issue 394).<\/li>\n<li>Changed so that instead of connection to localhost it is using $env:COMPUTERNAME as the host name to which it connects. And for cluster installation it uses the parameter FailoverClusterNetworkName as the host name to which it connects (issue 407).<\/li>\n<li>When called with Action = &#8220;PrepareFailoverCluster&#8221;, the SQLSysAdminAccounts and FailoverClusterGroup parameters are no longer passed to the setup process (issues 410 and 411).<\/li>\n<li>Solved the problem that InstanceDir and InstallSQLDataDir could not be set to just a qualifier, i.e &#8220;E:&#8221; (issue 418). All paths (except SourcePath) can now be set to just the qualifier.<\/li>\n<\/ul>\n<\/li>\n<li>Enables CodeCov.io code coverage reporting.<\/li>\n<li>Added badge for CodeCov.io to README.md.<\/li>\n<li>Examples\n<ul>\n<li>xSQLServerMaxDop\n<ul>\n<li>1-SetMaxDopToOne.ps1<\/li>\n<li>2-SetMaxDopToAuto.ps1<\/li>\n<li>3-SetMaxDopToDefault.ps1<\/li>\n<\/ul>\n<\/li>\n<li>xSQLServerMemory\n<ul>\n<li>1-SetMaxMemoryTo12GB.ps1<\/li>\n<li>2-SetMaxMemoryToAuto.ps1<\/li>\n<li>3-SetMinMaxMemoryToAuto.ps1<\/li>\n<li>4-SetMaxMemoryToDefault.ps1<\/li>\n<\/ul>\n<\/li>\n<li>xSQLServerDatabase\n<ul>\n<li>1-CreateDatabase.ps1<\/li>\n<li>2-DeleteDatabase.ps1<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li>Added tests for resources\n<ul>\n<li>xSQLServerMaxDop<\/li>\n<li>xSQLServerMemory<\/li>\n<\/ul>\n<\/li>\n<li>Changes to xSQLServerMemory\n<ul>\n<li>BREAKING CHANGE: The mandatory parameter now include SQLInstanceName. The DynamicAlloc parameter is no longer mandatory<\/li>\n<\/ul>\n<\/li>\n<li>Changes to xSQLServerDatabase\n<ul>\n<li>When the system is not in desired state the Test-TargetResource will now output verbose messages saying so.<\/li>\n<\/ul>\n<\/li>\n<li>Changes to xSQLServerDatabaseOwner\n<ul>\n<li>Fixed code style, added updated parameter descriptions to schema.mof and README.md.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>xWindowsUpdate<\/td>\n<td>2.6.0.0<\/td>\n<td>\n<ul>\n<ul>\n<li>Converted appveyor.yml to install Pester from PSGallery instead of from<\/li>\n<\/ul>\n<\/ul>\n<p>Chocolatey.<\/p>\n<ul>\n<li>Fixed PSScriptAnalyzer issues.<\/li>\n<li>Fixed common test breaks (markdown style, and example style).<\/li>\n<li>Added CodeCov.io reporting<\/li>\n<li>Deprecated xMicrosoftUpdate as it&#8221;s functionality is replaced by xWindowsUpdateAgent<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How to Find Released DSC Resource Modules<\/h2>\n<p>To see a list of <strong>all<\/strong> released DSC Resource Kit modules, go to the <a href=\"http:\/\/www.powershellgallery.com\/\">PowerShell Gallery<\/a> and display <a href=\"http:\/\/www.powershellgallery.com\/packages?q=Tags%3A%22DSCResourceKit%22\">all modules tagged as DSCResourceKit<\/a>. You can also enter a module&#8217;s name in the search box in the upper right corner of the PowerShell Gallery to find a specific module.<\/p>\n<p>Of course, you can also always use PowerShellGet (available in <a href=\"https:\/\/www.microsoft.com\/en-us\/download\/details.aspx?id=50395\">WMF 5.0<\/a>) to find modules with DSC Resources:<\/p>\n<div class=\"highlight highlight-source-powershell\">\n<pre><span class=\"pl-c\"># To list all modules that are part of the DSC Resource Kit<\/span>\n<span class=\"pl-c1\">Find-Module<\/span> <span class=\"pl-k\">-<\/span>Tag DSCResourceKit \n<span class=\"pl-c\"># To list all DSC resources from all sources <\/span>\n<span class=\"pl-c1\">Find-DscResource<\/span><\/pre>\n<\/div>\n<p>To find a <strong>specific<\/strong> module, go directly to its URL on the PowerShell Gallery:\n<a href=\"http:\/\/www.powershellgallery.com\/packages\/\">http:\/\/www.powershellgallery.com\/packages\/<\/a>&lt; module name &gt;\nFor example:\n<a href=\"http:\/\/www.powershellgallery.com\/packages\/xWebAdministration\">http:\/\/www.powershellgallery.com\/packages\/xWebAdministration<\/a><\/p>\n<h2>How to Install DSC Resource Modules From the PowerShell Gallery<\/h2>\n<p>We recommend that you use PowerShellGet to install DSC resource modules:<\/p>\n<div class=\"highlight highlight-source-powershell\">\n<pre><span class=\"pl-c1\">Install-Module<\/span> <span class=\"pl-k\">-<\/span>Name <span class=\"pl-k\">&lt;<\/span> module name <span class=\"pl-k\">&gt;<\/span><\/pre>\n<\/div>\n<p>For example:<\/p>\n<div class=\"highlight highlight-source-powershell\">\n<pre><span class=\"pl-c1\">Install-Module<\/span> <span class=\"pl-k\">-<\/span>Name xWebAdministration<\/pre>\n<\/div>\n<p>To update all previously installed modules at once, open an elevated PowerShell prompt and use this command:<\/p>\n<div class=\"highlight highlight-source-powershell\">\n<pre><span class=\"pl-c1\">Update-Module<\/span><\/pre>\n<\/div>\n<p>After installing modules, you can discover all DSC resources available to your local system with this command:<\/p>\n<div class=\"highlight highlight-source-powershell\">\n<pre><span class=\"pl-c1\">Get-DscResource<\/span><\/pre>\n<\/div>\n<h2>How to Find DSC Resource Modules on GitHub<\/h2>\n<p>All resource modules in the DSC Resource Kit are available open-source on GitHub.\nYou can see the most recent state of a resource module by visiting its GitHub page at:\n<a href=\"https:\/\/github.com\/PowerShell\/\">https:\/\/github.com\/PowerShell\/<\/a>&lt; module name &gt;\nFor example, for the xCertificate module, go to:\n<a href=\"https:\/\/github.com\/PowerShell\/xCertificate\">https:\/\/github.com\/PowerShell\/xCertificate<\/a>.<\/p>\n<p>All DSC modules are also listed as submodules of the <a href=\"https:\/\/github.com\/PowerShell\/DscResources\/\">DscResources repository<\/a> in the <a href=\"https:\/\/github.com\/PowerShell\/DscResources\/tree\/master\/xDscResources\">xDscResources folder<\/a>.<\/p>\n<h2>How to Contribute<\/h2>\n<p>You are more than welcome to contribute to the development of the DSC Resource Kit! There are several different ways you can help. You can create new DSC resources or modules, add test automation, improve documentation, fix existing issues, or open new ones.\nSee our <a href=\"https:\/\/github.com\/PowerShell\/DscResources\/blob\/master\/CONTRIBUTING.md\">contributing guide<\/a> for more info on how to become a DSC Resource Kit contributor.<\/p>\n<p>If you would like to help, please take a look at the list of <a href=\"https:\/\/github.com\/PowerShell\/DscResources\/issues\">open issues<\/a> for the DscResources repository.\nYou can also check issues for specific resource modules by going to:\n<a href=\"https:\/\/github.com\/PowerShell\/\">https:\/\/github.com\/PowerShell\/<\/a>&lt; module name &gt;\/issues\nFor example:\n<a href=\"https:\/\/github.com\/PowerShell\/xPSDesiredStateConfiguration\/issues\">https:\/\/github.com\/PowerShell\/xPSDesiredStateConfiguration\/issues<\/a><\/p>\n<p>Your help in developing the DSC Resource Kit is invaluable to us!<\/p>\n<h2>Questions, comments?<\/h2>\n<p>If you&#8217;re looking into using PowerShell DSC, have questions or issues with a current resource, or would like a new resource, let us know in the comments below, on Twitter (<a href=\"https:\/\/twitter.com\/PowerShell_Team\">@PowerShell_Team<\/a>), or by creating an issue on <a href=\"https:\/\/github.com\/powershell\/dscresources\/issues\">GitHub<\/a>.<\/p>\n<p>Katie Keim\nSoftware Engineer\nPowerShell Team\n<a href=\"https:\/\/twitter.com\/katiedsc\">@katiedsc<\/a> (Twitter)\n<a href=\"https:\/\/github.com\/kwirkykat\">@kwirkykat<\/a> (GitHub)<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>We just released the DSC Resource Kit! This release includes updates to 10 DSC resource modules, including 19 new DSC resources. In these past 6 weeks, 155 pull requests (the most ever!) have been merged and 71 issues have been closed, all thanks to our amazing community! A few weeks ago we also released a [&hellip;]<\/p>\n","protected":false},"author":618,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[150,152,290],"class_list":["post-13135","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-dsc","tag-dsc-resource-kit","tag-resources"],"acf":[],"blog_post_summary":"<p>We just released the DSC Resource Kit! This release includes updates to 10 DSC resource modules, including 19 new DSC resources. In these past 6 weeks, 155 pull requests (the most ever!) have been merged and 71 issues have been closed, all thanks to our amazing community! A few weeks ago we also released a [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/13135","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\/618"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=13135"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/13135\/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=13135"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=13135"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=13135"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}