community.windows.win_file_version – Get DLL or EXE file build version
Note
This plugin is part of the community.windows collection (version 1.7.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 | Choices/Defaults | 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 | Returned | Description |
|---|---|---|
| file_build_part string | no error | build number of the file. |
| file_major_part string | no error | the major part of the version number. |
| file_minor_part string | no error | the minor part of the version number of the file. |
| file_private_part string | no error | file private part number. |
| file_version string | no error | File version number.. |
| path string | always | file path |
| product_version string | no error | The version of the product this file is distributed with. |
Authors
- Sam Liu (@SamLiu79)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_file_version_module.html