salt.states.win_update¶

Management of the windows update agent¶

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.installed:
        - 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.