xWindowsUpdate
This module contains DSC resources for configuration of Microsoft Windows Update and installing Windows updates.
Code of Conduct
This project has adopted this Code of Conduct.
Releases
For each merge to the branch master
a preview release will be
deployed to PowerShell Gallery.
Periodically a release version tag will be pushed which will deploy a
full release to PowerShell Gallery.
Contributing
Please check out common DSC Community contributing guidelines.
Resources
xHotfix
Parameters
[String]
Path: Specifies the path that contains the file for the hotfix installation.[String]
Log: Specifies the location of the log that contains information from the install or uninstall. If not specified a temporary log name is created by the resource.[String]
Id: Specifies the hotfix ID of the Windows update that uniquely identifies the hotfix.[String]
Ensure: Specifies whether the hotfix should be installed or uninstalled. Default value is'Present'
. { Present | Absent }[PSCredential]
Credential: Specifies the credential to use to authenticate to a UNC share if the path is on a UNC share.
Read-Only Properties from Get-TargetResource
None.
xWindowsUpdateAgent
Parameters
[String]
IsSingleInstance: Specifies the resource is a single instance, the value must be 'Yes'.[System.Boolean]
UpdateNow: Specifies if the resource should trigger an update during consistency check including initial configuration.[String[]]
Category: Specifies one or more categories of updates that should be included. Defaults to'Security'
. Please note that security is not mutually exclusive with Important and Optional, so selecting Important may install some security updates, etcetera. { Security | Important | Optional }[String]
Notifications: Specifies if the Windows update agent should notify about updates. { Disabled | ScheduledInstallation }[String]
Source: Specifies which source service Windows update agent should use when searching for updates. Note that the option 'WSUS' is currently reserved for future use and not yet implemented. { MicrosoftUpdate | WindowsUpdate | WSUS }[SInt32]
RetryAttempts: Specifies the number of retries when some known transient errors are raised during calls to Windows Update. Defaults to3
. Known transient errors are 0x8024402c, 0x8024401c, 0x80244022, and 0x80244010.[SInt32]
RetryDelay: Specifies the delay in seconds before each retry. Defaults to0
.
Read-Only Properties from Get-TargetResource
[String]
AutomaticUpdatesNotificationSetting: Automatic Updates Notification Setting.[UInt32]
TotalUpdatesNotInstalled: Count of updates not installed. Only returned if UpdateNow is specified.[System.Boolean]
RebootRequired: Indicates if Wua Requires a reboot. Only returned if UpdateNow is specified.