This module contains DSC resources for configuration of Microsoft Windows Update and installing Windows updates.

Minimum PowerShell version


This is a prerelease version of xWindowsUpdate.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name xWindowsUpdate -AllowPrerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deloy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More


DSC Community


Copyright the DSC Community contributors. All rights reserved.



DesiredStateConfiguration DSC DSCResourceKit DSCResource


xHotFix xWindowsUpdateAgent


This module has no dependencies.

Release Notes

## [3.0.0-preview0001] - 2020-03-21

### Added

- xWindowsUpdate
 - Added automatic release with a new CI pipeline.
- xWindowsUpdateAgent
 - Added Retry logic to known transient errors ([issue #24](https://github.com/dsccommunity/xWindowsUpdate/issues/24)).

### Changed

- xWindowsUpdate
 - Moved the `Set-StrictMode` so that it is used during testing only and
   not during runtime.
 - Removed the helper function `Trace-Message` and using the `Write-Verbose`
   directly instead.
 - The helper function `New-InvalidArgumentException` was replaced by
   its equivalent in the module DscResource.Common.
- xWindowsUpdateAgent
 - Removed the `$PSCmdlet.ShouldProcess` calls from code since DSC does not
   support interactive actions.
 - No longer defaults to output verbose messages.

### Removed

- xWindowsUpdate
 - BREAKING CHANGE: Removed the deprecated resource `xMicrosoftUpdate`

## [] - 2019-04-03

- xWindowsUpdateAgent: Fixed verbose statement returning incorrect variable
- Tests no longer fail on `Assert-VerifiableMocks`, these are now renamed
 to `Assert-VerifiableMock` (breaking change in Pester v4).
- README.md has been updated with correct description of the resources
 ([issue #58](https://github.com/dsccommunity/xWindowsUpdate/issues/58)).
- Updated appveyor.yml to use the correct parameters to call the test framework.
- Update appveyor.yml to use the default template.
- Added default template files .gitattributes, and .gitignore, and
 .vscode folder.

## [] - 2017-07-12

- xWindowsUpdateAgent: Fix Get-TargetResource returning incorrect key

## [] - 2017-03-08

- Converted appveyor.yml to install Pester from PSGallery instead of from
- Fixed PSScriptAnalyzer issues.
- Fixed common test breaks (markdown style, and example style).
- Added CodeCov.io reporting
- Deprecated xMicrosoftUpdate as it's functionality is replaced by

## [] - 2016-05-18

- Added xWindowsUpdateAgent

## [] - 2016-03-30

- Fixed PSScriptAnalyzer error in examples

## [] - 2016-02-02

- MSFT_xWindowsUpdate: Fixed an issue in the Get-TargetResource function,
 resulting in the Get-DscConfiguration cmdlet now working appropriately
 when the resource is applied.
- MSFT_xWindowsUpdate: Fixed an issue in the Set-TargetResource function
 that was causing the function to fail when the installation of a hotfix
 did not provide an exit code.

## [] - 2015-09-11

- Minor fixes

## [] - 2015-07-24

- Added xMicrosoftUpdate DSC resource which can be used to enable/disable
 Microsoft Update in the Windows Update Settings.


## [] - 2015-04-23

- Initial release with the xHotfix resource

Version History

Version Downloads Last updated
3.0.0-previe... (current version) 904 3/21/2020 222,372 4/3/2019 6,477,647 7/12/2017 17,907 3/8/2017 20,471 5/18/2016 881 3/31/2016 678 2/3/2016 2,940 9/11/2015 352 7/24/2015
2.0.0 341 4/24/2015
1.0 1,322 6/7/2014