win_msi – Installs and uninstalls Windows MSI files
New in version 1.7.
DEPRECATED
Removed in Ansible: | |
---|---|
version: 2.8 | |
Why: | The win_msi module has a number of issues, the win_package module is easier to maintain and use. |
Alternative: | Use win_package instead. |
Synopsis
- Installs or uninstalls a Windows MSI file that is already located on the target server.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
creates path | Path to a file created by installing the MSI to prevent from attempting to reinstall the package on every run. | |
extra_args - | Additional arguments to pass to the msiexec.exe command. | |
path path / required | File system path to the MSI file to install. | |
removes path added in 2.4 | Path to a file removed by uninstalling the MSI to prevent from attempting to re-uninstall the package on every run. | |
state - |
| Whether the MSI file should be installed or uninstalled. |
wait boolean added in 2.1 |
| Specify whether to wait for install or uninstall to complete before continuing. |
Notes
Note
- This module is not idempotent and will report a change every time. Use the
creates
andremoves
options to your advantage. - Please look into win_package instead, this package will be deprecated in the future.
Examples
- name: Install an MSI file win_msi: path: C:\7z920-x64.msi - name: Install an MSI, and wait for it to complete before continuing win_msi: path: C:\7z920-x64.msi wait: yes - name: Uninstall an MSI file win_msi: path: C:\7z920-x64.msi state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
log string | always | The logged output from the installer Sample: N/A |
Status
- This module will be removed in version 2.8. [deprecated]
- For more information see DEPRECATED.
Authors
- Matt Martz (@sivel)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_msi_module.html