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

Новое в версии 2.1.

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

Описание

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

Параметры

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

Примечания

Примечание

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

См. также

win_reg_stat – Получение информации о ключах реестра Windows: Официальная документация модуля win_reg_stat.
win_regedit – Добавление, изменение или удаление ключей и значений реестра: Официальная документация модуля win_regedit.

Примеры

- 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

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

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

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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.8/modules/win_regmerge_module.html