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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
compare_key строка		Родительский ключ для сравнения содержимого реестра с содержимым файла. Должен быть в HKLM или HKCU части реестра. Используйте путь в стиле PS-Drive, например, 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 булево	при отсутствии ключа сравнения в реестре	Указывает, был ли найден родительский ключ реестра для сравнения
compared булево	если ключ сравнения был указан и сравнение было выполнено	Указывает, было ли выполнено сравнение между реестром и файлом Пример: Истина
difference_count целое число	изменения	Количество различий между реестром и файлом Пример: 1

Статус

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

Авторы

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