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)