win_msi – Installs and uninstalls Windows MSI files

From Get docs
Ansible/docs/2.7/modules/win msi module


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

-

  • absent
  • present

Whether the MSI file should be installed or uninstalled.

wait

boolean

added in 2.1

  • no

  • yes

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 and removes 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