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

Note

This module is part of the community.windows collection (version 2.4.0).

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.win_file_version }}'

Return Values

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

Key

Description

win_file_version

complex

dictionary containing all the version data

Returned: success

file_build_part

string

build number of the file.

Returned: no error

Sample: "2"

file_major_part

string

the major part of the version number.

Returned: no error

Sample: "0"

file_minor_part

string

the minor part of the version number of the file.

Returned: no error

Sample: "30"

file_private_part

string

file private part number.

Returned: no error

Sample: "0"

file_version

string

File version number.

Returned: no error

Sample: "v0.30.2"

file_version_raw

string

added in community.windows 2.4.0

File version number that may not match the file_version

Returned: no error

Sample: "0.30.2.0"

path

string

file path

Returned: always

product_version

string

The version of the product this file is distributed with.

Returned: no error

Sample: "0.30.2+b4a594409fc9e79e7c5161763cf1c4328e9c5a5d"

Authors

  • Sam Liu (@SamLiu79)

  • Mikhail Samodurov (@EasyMoney322)