22.27.125.1. Management of the windows update agent
New in version 2014.7.0.
Set windows updates to run by category. Default behavior is to install
all updates that do not require user interaction to complete.
Optionally set category to a category of your choosing to only
install certain updates. default is all available updates.
In the example below, will install all Security and Critical Updates,
and download but not install standard updates.
Example:
updates:
win_update.installed:
- categories:
- 'Critical Updates'
- 'Security Updates'
win_update.downloaded:
- categories:
- 'Updates'
You can also specify a number of features about the update to have a
fine grain approach to specific types of updates. These are the following
features/states of updates available for configuring:
- UI - User interaction required, skipped by default
- downloaded - Already downloaded, skipped by default (downloading)
- present - Present on computer, included by default (installing)
- installed - Already installed, skipped by default
- reboot - Reboot required, included by default
- hidden - skip those updates that have been hidden.
- software - Software updates, included by default
- driver - driver updates, skipped by default
This example installs all driver updates that don't require a reboot:
Example:
gryffindor:
win_update.install:
- includes:
- driver: True
- software: False
- reboot: False
-
class salt.states.win_update.PyWinUpdater(categories=None, skipUI=True, skipDownloaded=True, skipInstalled=True, skipReboot=False, skipPresent=True, softwareUpdates=True, driverUpdates=False, skipHidden=True)
-
AutoSearch()
-
Download()
-
GetAvailableCategories()
-
GetCategories()
-
GetDownloadResults()
-
GetInstallationResults()
-
Install()
-
Search(searchString)
-
SetCategories(categories)
-
SetInclude(include, state)
-
SetIncludes(includes)
-
salt.states.win_update.downloaded(name, categories=None, includes=None, retries=10)
Cache updates for later install.
- name
- If categories is left empty, it will be assumed that you are
passing the category option through the name. These are separate
because you can only have one name, but can have multiple categories.
- categories
The list of categories to be downloaded. These are simply strings in
the update's information, so there is no enumeration of the categories
available. Known categories include:
- Updates
- Windows 7
- Critical Updates
- Security Updates
- Update Rollups
- includes
A list of features of the updates to cull by. Available features
include:
- UI - User interaction required, skipped by default
- downloaded - Already downloaded, skipped by default (downloading)
- present - Present on computer, included by default (installing)
- installed - Already installed, skipped by default
- reboot - Reboot required, included by default
- hidden - Kkip those updates that have been hidden.
- software - Software updates, included by default
- driver - Driver updates, skipped by default
- retries
- Number of retries to make before giving up. This is total, not per
step.
-
salt.states.win_update.installed(name, categories=None, includes=None, retries=10)
Install specified windows updates.
- name
- If categories is left empty, it will be assumed that you are
passing the category option through the name. These are separate
because you can only have one name, but can have multiple categories.
- categories
The list of categories to be downloaded. These are simply strings in
the update's information, so there is no enumeration of the categories
available. Known categories include:
- Updates
- Windows 7
- Critical Updates
- Security Updates
- Update Rollups
- includes
A list of features of the updates to cull by. Available features
include:
- UI - User interaction required, skipped by default
- downloaded - Already downloaded, skipped by default (downloading)
- present - Present on computer, included by default (installing)
- installed - Already installed, skipped by default
- reboot - Reboot required, included by default
- hidden - Kkip those updates that have been hidden.
- software - Software updates, included by default
- driver - Driver updates, skipped by default
- retries
- Number of retries to make before giving up. This is total, not per
step.