Version information
This version is compatible with:
- Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x
- Puppet >= 5.5.8 < 7.0.0
This module has been deprecated by its author since Jun 26th 2023.
Start using this module
Documentation
Windows Automatic Updates module for Puppet
Table of Contents
- Overview
- Module Description - What is the windows_autoupdate module?
- Setup - The basics of getting started with windows_autoupdate
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Overview
Puppet module for managing Microsoft Windows Automatic Updates.
Module Description
This module configures all the relevant windows registry keys used to manage windows automatic update settings on your windows machine.
Setup
What autoupdates affects
- Configures registry keys/values
Beginning with autoupdate
Manage autoupdates with default settings:
include windows_autoupdate
Disable auto updates:
class { 'windows_autoupdate': noAutoUpdate => '1' }
Usage
Classes and Defined Types
Class: windows_autoupdate
The autoupdate module primary classes, windows_autoupdate
, configures all the
registry settings required to manage auto updates.
Parameters within windows_autoupdates
:
no_auto_update
- 0 - Enable Automatic Updates (Default)
- 1 - Disable Automatic Updates
au_options
- 2 - Notify for download and notify for install
- 3 - Auto download and notify for install
- 4 - Auto download and schedule the install
scheduled_install_day
- 0 - Install every day
- 1 to 7 - Install on specific day of the week from Sunday (1) to Saturday (7).
scheduled_install_time
- 0 to 23 - Install time of day in 24-hour format
use_wuserver
- 1 to use custom update server
reschedule_wait_time
- The number of minutes to wait after service start time before performing the installation.
no_auto_reboot_with_logged_on_users
- 1 to prevent automatic reboot while users are logged on.
Reference
Classes
Public Classes
windows_autoupdates
: Guides the basic management of windows auto update settings.
Limitations
This module is tested on the following platforms:
- Windows 2008 R2
It is tested with the OSS version of Puppet only.
Development
Contributing
Please read CONTRIBUTING.md for full details on contributing to this project.
Changelog
All notable changes to this project will be documented in this file. Each new release typically also includes the latest modulesync defaults. These should not affect the functionality of the module.
v3.0.0 (2019-03-09)
Breaking changes:
- modulesync 2.6.0 & drop Puppet 4 #61 (bastelfreak)
Merged pull requests:
- Remove Linux acceptance nodesets #58 (ekohl)
- modulesync 2.2.0 and allow puppet 6.x #57 (bastelfreak)
v2.0.1 (2018-09-07)
Merged pull requests:
- allow puppetlabs/registry 2.x #55 (bastelfreak)
- allow puppetlabs/stdlib 5.x #53 (bastelfreak)
- Remove docker nodesets #50 (bastelfreak)
- drop EOL OSs; fix puppet version range #49 (bastelfreak)
v2.0.0 (2017-11-17)
Merged pull requests:
- release 2.0.0 #46 (bastelfreak)
- bump puppet version dependency to >= 4.7.1 \< 6.0.0 #45 (bastelfreak)
v1.2.0 (2017-02-11)
This is the last release with Puppet3 support!
- Remove mixed case parameters, modulesync (0.3.0)
- Fix several Rubocop issues
- Fix several markdown issues
- Add missing badges
- Fix several rubocop issues
- Set min version_requirement for Puppet + bump deps
2016-03-29 Release 1.1.0
- Deprecate mixed case parameters
2015-03-19 Release 1.0.1
- fixing bug in puppet-community release
2015-03-19 Release 1.0.0
- first puppet-community supported version
2015-01-16 Release 0.1.0
- support for windows 2012
2013-05-01 Release 0.0.2
- less restrictive dependency on stdlib
2013-04-26 Release 0.0.1
- initial version
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 4.6.0 < 6.0.0)
- puppetlabs/registry (>= 1.1.1 < 3.0.0)
Copyright (c) 2014 Liam Bennett (liamjbennett@gmail.com) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.