win_file_version – Get DLL or EXE file build version

New in version 2.1.

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

win_file – Creates, touches or removes files or directories
The official documentation on the win_file module.

Examples

- name: Get acm instance version
  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.



Status

Authors

  • Sam Liu (@SamLiu79)

Hint

If you notice any issues in this documentation you can edit this document to improve it.