New in version 2.4.
Parameter | Choices/Defaults | Comments |
---|---|---|
hotfix_identifier |
The name of the hotfix as shown in DISM, see examples for details.
This or
hotfix_kb MUST be set when state=absent .If
state=present then the hotfix at source will be validated against this value, if it does not match an error will occur.You can get the identifier by running 'Get-WindowsPackage -Online -PackagePath path-to-cab-in-msu' after expanding the msu file.
|
|
hotfix_kb |
The name of the KB the hotfix relates to, see examples for details.
This of
hotfix_identifier MUST be set when state=absent .If
state=present then the hotfix at source will be validated against this value, if it does not match an error will occur.Because DISM uses the identifier as a key and doesn't refer to a KB in all cases it is recommended to use
hotfix_identifier instead. |
|
source |
The path to the downloaded hotfix .msu file.
This MUST be set if
state=present and MUST be a .msu hotfix file. |
|
state |
|
Whether to install or uninstall the hotfix.
When
present , source MUST be set.When
absent , hotfix_identifier or hotfix_kb MUST be set. |
Note
- name: install Windows ADK with DISM for Server 2008 R2
win_chocolatey:
name: windows-adk
version: 8.100.26866.0
state: present
install_args: /features OptionId.DeploymentTools
- name: install hotfix without validating the KB and Identifier
win_hotfix:
source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
state: present
register: hotfix_install
- win_reboot:
when: hotfix_install.reboot_required
- name: install hotfix validating KB
win_hotfix:
hotfix_kb: KB3172729
source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
state: present
register: hotfix_install
- win_reboot:
when: hotfix_install.reboot_required
- name: install hotfix validating Identifier
win_hotfix:
hotfix_identifier: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
state: present
register: hotfix_install
- win_reboot:
when: hotfix_install.reboot_required
- name: uninstall hotfix with Identifier
win_hotfix:
hotfix_identifier: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
state: absent
register: hotfix_uninstall
- win_reboot:
when: hotfix_uninstall.reboot_required
- name: uninstall hotfix with KB (not recommended)
win_hotfix:
hotfix_kb: KB3172729
state: absent
register: hotfix_uninstall
- win_reboot:
when: hotfix_uninstall.reboot_required
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
identifier
str
|
success |
The DISM identifier for the hotfix.
Sample:
Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
|
kb
str
|
success |
The KB the hotfix relates to.
Sample:
KB3172729
|
reboot_required
str
|
success |
Whether a reboot is required for the install or uninstall to finalise.
Sample:
True
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.