{"id":20156300,"url":"https://github.com/dsccommunity/xwindowsupdate","last_synced_at":"2025-12-11T21:33:42.326Z","repository":{"id":30468283,"uuid":"34022269","full_name":"dsccommunity/xWindowsUpdate","owner":"dsccommunity","description":"This module contains DSC resources for configuration of Microsoft Windows Update and installing Windows updates.","archived":false,"fork":false,"pushed_at":"2020-07-02T11:36:07.000Z","size":234,"stargazers_count":85,"open_issues_count":17,"forks_count":37,"subscribers_count":33,"default_branch":"master","last_synced_at":"2024-03-14T16:04:49.531Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"MorrisMA/M65C02A","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsccommunity.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-15T22:43:10.000Z","updated_at":"2024-02-29T08:07:42.000Z","dependencies_parsed_at":"2022-08-07T15:15:53.232Z","dependency_job_id":null,"html_url":"https://github.com/dsccommunity/xWindowsUpdate","commit_stats":null,"previous_names":["powershell/xwindowsupdate"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxWindowsUpdate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxWindowsUpdate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxWindowsUpdate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxWindowsUpdate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsccommunity","download_url":"https://codeload.github.com/dsccommunity/xWindowsUpdate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248120952,"owners_count":21051056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T23:38:20.285Z","updated_at":"2025-12-11T21:33:42.242Z","avatar_url":"https://github.com/dsccommunity.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xWindowsUpdate\r\n\r\n[![Build Status](https://dev.azure.com/dsccommunity/xWindowsUpdate/_apis/build/status/dsccommunity.xWindowsUpdate?branchName=master)](https://dev.azure.com/dsccommunity/xWindowsUpdate/_build/latest?definitionId=26\u0026branchName=master)\r\n![Azure DevOps coverage (branch)](https://img.shields.io/azure-devops/coverage/dsccommunity/xWindowsUpdate/26/master)\r\n[![codecov](https://codecov.io/gh/dsccommunity/xWindowsUpdate/branch/master/graph/badge.svg)](https://codecov.io/gh/dsccommunity/xWindowsUpdate)\r\n[![Azure DevOps tests](https://img.shields.io/azure-devops/tests/dsccommunity/xWindowsUpdate/26/master)](https://dsccommunity.visualstudio.com/xWindowsUpdate/_test/analytics?definitionId=26\u0026contextType=build)\r\n[![PowerShell Gallery (with prereleases)](https://img.shields.io/powershellgallery/vpre/xWindowsUpdate?label=xWindowsUpdate%20Preview)](https://www.powershellgallery.com/packages/xWindowsUpdate/)\r\n[![PowerShell Gallery](https://img.shields.io/powershellgallery/v/xWindowsUpdate?label=xWindowsUpdate)](https://www.powershellgallery.com/packages/xWindowsUpdate/)\r\n\r\nThis module contains DSC resources for configuration of Microsoft Windows Update\r\nand installing Windows updates.\r\n\r\n## Code of Conduct\r\n\r\nThis project has adopted this [Code of Conduct](CODE_OF_CONDUCT.md).\r\n\r\n## Releases\r\n\r\nFor each merge to the branch `master` a preview release will be\r\ndeployed to [PowerShell Gallery](https://www.powershellgallery.com/).\r\nPeriodically a release version tag will be pushed which will deploy a\r\nfull release to [PowerShell Gallery](https://www.powershellgallery.com/).\r\n\r\n## Contributing\r\n\r\nPlease check out common DSC Community [contributing guidelines](https://dsccommunity.org/guidelines/contributing).\r\n\r\n## Resources\r\n\r\n### xHotfix\r\n\r\n#### Parameters\r\n\r\n- **`[String]` Path**: Specifies the path that contains the file for the\r\n  hotfix installation.\r\n- **`[String]` Log**: Specifies the location of the log that contains\r\n  information from the install or uninstall. If not specified a temporary\r\n  log name is created by the resource.\r\n- **`[String]` Id**: Specifies the hotfix ID of the Windows update that\r\n  uniquely identifies the hotfix.\r\n- **`[String]` Ensure**: Specifies whether the hotfix should be installed\r\n  or uninstalled. Default value is `'Present'`. { _Present_ | Absent }\r\n- **`[PSCredential]` Credential**: Specifies the credential to use to\r\n  authenticate to a UNC share if the path is on a UNC share.\r\n\r\n#### Read-Only Properties from Get-TargetResource\r\n\r\nNone.\r\n\r\n### xWindowsUpdateAgent\r\n\r\n#### Parameters\r\n\r\n- **`[String]` IsSingleInstance**: Specifies the resource is a single\r\n  instance, the value must be 'Yes'.\r\n- **`[System.Boolean]` UpdateNow**: Specifies if the resource should trigger an\r\n  update during consistency check including initial configuration.\r\n- **`[String[]]` Category**: Specifies one or more categories of updates\r\n  that should be included. Defaults to `'Security'`. Please note that\r\n  security is not mutually exclusive with Important and Optional, so\r\n  selecting Important may install some security updates, etcetera.\r\n  { _Security_ | Important | Optional }\r\n- **`[String]` Notifications**: Specifies if the Windows update agent should\r\n  notify about updates. { Disabled | ScheduledInstallation }\r\n- **`[String]` Source**: Specifies which source service Windows update agent\r\n  should use when searching for updates. Note that the option 'WSUS' is\r\n  currently reserved for future use and not yet implemented.\r\n  { MicrosoftUpdate | WindowsUpdate | WSUS }\r\n- **`[SInt32]` RetryAttempts**: Specifies the number of retries when some\r\n  known transient errors are raised during calls to Windows Update. Defaults\r\n  to `3`. Known transient errors are 0x8024402c, 0x8024401c, 0x80244022,\r\n  and 0x80244010.\r\n- **`[SInt32]` RetryDelay**: Specifies the delay in seconds before each\r\n  retry. Defaults to `0`.\r\n\r\n#### Read-Only Properties from Get-TargetResource\r\n\r\n- **`[String]` AutomaticUpdatesNotificationSetting**: Automatic Updates\r\n  Notification Setting.\r\n- **`[UInt32]` TotalUpdatesNotInstalled**: Count of updates not installed.\r\n  Only returned if UpdateNow is specified.\r\n- **`[System.Boolean]` RebootRequired**: Indicates if Wua Requires a reboot. Only\r\n  returned if UpdateNow is specified.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxwindowsupdate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsccommunity%2Fxwindowsupdate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxwindowsupdate/lists"}