community.windows.win_regmerge – Объединяет содержимое файла реестра в реестр Windows

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в книге задач укажите: community.windows.win_regmerge.

Краткое описание
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Краткое описание

Оборачивает команду reg.exe для импорта содержимого файла реестра.
Подходит для использования с файлами реестра, созданными с помощью ansible.windows.win_template.
Файлы реестра Windows имеют специфический формат и должны быть корректно сформированы с переносами строк типа carriage return и line feed, иначе они не будут объединены.
Экспортированные файлы реестра часто начинаются с маркера порядка байтов (BOM), который нужно удалить, если файл предполагается использовать с ansible.windows.win_template.
Формат файлов реестра описан по адресу https://support.microsoft.com/en-us/kb/310516
См. также ansible.windows.win_template, ansible.windows.win_regedit

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
compare_key строка		Ключ родительского раздела для сравнения содержимого реестра с содержимым файла. Должен находиться в части реестра HKLM или HKCU. Используйте путь в стиле PS-Drive, например, HKLM:\SOFTWARE, а не HKEY_LOCAL_MACHINE\SOFTWARE. Если не задано или ключ реестра не найден, сравнение не будет выполнено, и модуль сообщит об изменениях.
path путь / обязательно		Полный путь, включая имя файла, к файлу реестра на удалённой машине для объединения.

Примечания

Примечание

Организуйте файлы реестра так, чтобы они содержали один корневой ключ реестра, если вы хотите использовать функциональность сравнения.
Этот модуль не принуждает настройки реестра соответствовать состоянию, описанному в файле. Если настройки реестра были изменены внешне, модуль объединит содержимое файла, но продолжит сообщать о различиях при последующих запусках.
Чтобы принудительно изменить реестр, используйте ansible.windows.win_regedit с state=absent перед использованием community.windows.win_regmerge.

См. также

ansible.windows.win_reg_stat: Официальная документация модуля ansible.windows.win_reg_stat.
ansible.windows.win_regedit: Официальная документация модуля ansible.windows.win_regedit.

Примеры

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

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

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Возвращённое значение	Описание
compare_to_key_found булево	при отсутствии ключа сравнения в реестре	указывает, был ли найден родительский ключ реестра для сравнения
compared булево	когда ключ сравнения был предоставлен и сравнение было выполнено	указывает, было ли проведено сравнение между реестром и файлом Пример: True
difference_count целое число	изменён	количество различий между реестром и файлом Пример: 1

Авторы

Jon Hawkesworth (@jhawkesworth)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_regmerge_module.html