win_regmerge - Merges the contents of a registry file into the windows registry

New in version 2.1.

Synopsis

Parameters

Parameter Choices/Defaults Comments
compare_key
The parent key to use when comparing the contents of the registry to the contents of the file. Needs to be in HKLM or HKCU part of registry. Use a PS-Drive style path for example HKLM:\SOFTWARE not HKEY_LOCAL_MACHINE\SOFTWARE If not supplied, or the registry key is not found, no comparison will be made, and the module will report changed.
path
path

required
The full path including file name to the registry file on the remote machine to be merged

Notes

Note

  • Organise your registry files so that they contain a single root registry key if you want to use the compare_to functionality. This module does not force registry settings to be in the state described in the file. If registry settings have been modified externally the module will merge the contents of the file but continue to report differences on subsequent runs. To force registry change, use win_regedit with state=absent before using win_regmerge.

Examples

- name: Merge in a registry file without comparing to current registry
  win_regmerge:
    path: C:\autodeploy\myCompany-settings.reg

- name: Compare and merge registry file
  win_regmerge:
    path: C:\autodeploy\myCompany-settings.reg
    compare_to: HKLM:\SOFTWARE\myCompany

Return Values

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

Key Returned Description
compare_to_key_found
boolean
when comparison key not found in registry
whether the parent registry key has been found for comparison

compared
boolean
when a comparison key has been supplied and comparison has been attempted
whether a comparison has taken place between the registry and the file

Sample:
True
difference_count
int
changed
number of differences between the registry and the file

Sample:
1


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Jon Hawkesworth (@jhawkesworth)

Hint

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