This release includes updates to 14 DSC resource modules, including 15 new DSC resources. In these past 6 weeks, 94 pull requests have been merged and 81 issues have been closed, all thanks to our amazing community!

The modules updated in this release are:

OfficeOnlineServerDsc

SharePointDsc

SystemLocaleDsc

xDscDiagnostics

xExchange

xNetworking

xPSDesiredStateConfiguration

xSCSMA

xSmbShare

xSQLServer

xStorage

xSystemSecurity

xTimeZone

xWebAdministration

For a detailed list of the resource modules and fixes in this release, see the Included in this Release section below.

Our last community call for the DSC Resource Kit was last week on September 15. Thank you to everyone who joined the call! If you missed it, a recording, an IM transcript, and summarizing notes are available. Join us next time to ask questions and give feedback about your experience with the DSC Resource Kit. Keep an eye on the community agenda for the next call date.

We strongly encourage you to update to the newest version of all modules using the PowerShell Gallery, and don’t forget to give us your feedback in the comments below, on GitHub, or on Twitter (@PowerShell_Team)!

As with past Resource Kits, all resources with the ‘x’ prefix in their names are still experimental – 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 file an issue on GitHub.

Included in this Release

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).

Module Name

Version

Release Notes

OfficeOnlineServerDsc

0.1.0.0, 0.2.0.0

0.1.0.0

Initial release

0.2.0.0

Fixed a bug that caused OfficeOnlineServerWebAppsMachine to fail a test when the machine to join was specified using a fully qualified domain name (FQDN)

SharePointDSC

1.3.0.0

Fixed typo on return value in SPServiceAppProxyGroup

Fixed SPJoinFarm to not write output during successful farm join

Fixed issue with SPSearchTopology to keep array of strings in the hashtable returned by Get-Target

Fixed issue with SPSearchTopology that prevented topology from updating where ServerName was not returned on each component

Added ProxyName parameter to all service application resources

Changed SPServiceInstance to look for object type names instead of the display name to ensure consistency with language packs

Fixed typos in documentation for InstallAccount parameter on most resources

Fixed a bug where SPQuotaTemplate would not allow warning and limit values to be equal

New resources: SPConfigWizard, SPProductUpdate and SPPublishServiceApplication

Updated style of all script in module to align with PowerShell team standards

Changed parameter ClaimsMappings in SPTrustedIdentityTokenIssuer to consume an array of custom object MSFT_SPClaimTypeMapping

Changed SPTrustedIdentityTokenIssuer to throw an exception if certificate specified has a private key, since SharePoint doesn’t accept it

Fixed issue with SPTrustedIdentityTokenIssuer to correctly get parameters ClaimProviderName and ProviderSignOutUri

Fixed issue with SPTrustedIdentityTokenIssuer to effectively remove the SPTrustedAuthenticationProvider from all zones before deleting the SPTrustedIdentityTokenIssuer

SystemLocaleDsc

1.0.0.0

Initial release

xSmbShare

2.0.0.0

Converted appveyor.yml to install Pester from PSGallery instead of from Chocolatey.

Added default value of “Present” for the Ensure parameter. (Note: due to how the module”s logic is written, this is a breaking change; DSC configs that did not specify a value for Ensure would have behaved as though it were set to Present in the Test-TargetResource function, but to absent in Set-TargetResource, removing the share instead of creating it.)

xTimeZone

1.6.0.0

Add support for Nano Server and WMF5.1 via Get-Timezone/Set-Timezone cmdlets.

Minor changes to bring make resource ready for HQRM.

Renamed and reworked functions in TimezoneHelper.psm1 to prevent conflicts with new built-in WMF5.1 Timezone Cmdlets.

Fixed localization so that failback to en-US if culture specific language files not available.

How to Install DSC Resource Modules From the PowerShell Gallery

We recommend that you use PowerShellGet to install DSC resource modules:

Install-Module-Name < module name >

For example:

Install-Module-Name xWebAdministration

To update all previously installed modules at once, open an elevated PowerShell prompt and use this command:

Update-Module

After installing modules, you can discover all DSC resources available to your local system with this command:

Get-DscResource

How to Find DSC Resource Modules on GitHub

All resource modules in the DSC Resource Kit are available open-source on GitHub.
You can see the most recent state of a resource module by visiting its GitHub page at:https://github.com/PowerShell/< module name >

How to Contribute

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.
See our contributing guide for more info on how to become a DSC Resource Kit contributor.

If you would like to help, please take a look at the list of open issues for the DscResources repository.
You can also check issues for specific resource modules by going to:https://github.com/PowerShell/< module name >/issues

Questions, comments?

If you’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 (@PowerShell_Team), or by creating an issue on GitHub.