You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

community.windows.win_file_version – Get DLL or EXE file build version

Note

This plugin is part of the community.windows collection (version 1.8.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.windows.

To use it in a playbook, specify: community.windows.win_file_version.

Synopsis

• Get DLL or EXE file build version.

Parameters

Parameter	Comments
path path / required	File to get version. Always provide absolute path.

Notes

Note

• This module will always return no change.

See Also

See also

ansible.windows.win_file

The official documentation on the ansible.windows.win_file module.

Examples

- name: Get acm instance version
  community.windows.win_file_version:
    path: C:\Windows\System32\cmd.exe
  register: exe_file_version

- debug:
    msg: '{{ exe_file_version }}'

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Description
file_build_part string	build number of the file. Returned: no error
file_major_part string	the major part of the version number. Returned: no error
file_minor_part string	the minor part of the version number of the file. Returned: no error
file_private_part string	file private part number. Returned: no error
file_version string	File version number.. Returned: no error
path string	file path Returned: always
product_version string	The version of the product this file is distributed with. Returned: no error

Authors

• Sam Liu (@SamLiu79)