win_regmerge - Объединяет содержимое файла реестра в реестр Windows
Новая версия 2.1.
Описание
- Оборачивает команду reg.exe для импорта содержимого файла реестра.
- Подходит для использования с файлами реестра, созданными с помощью win_template.
- Файлы реестра Windows имеют определенный формат и должны быть корректно построены с переносами строк, использующими символы возврата каретки и перевода строки (CRLF), в противном случае они не будут объединены.
- Экспортированные файлы реестра часто начинаются с маркера порядка байтов, который необходимо удалить, если файл будет используемо с шаблоном win_template.
- Формат файла реестра описан на https://support.microsoft.com/ru-ru/kb/310516
- См. также win_template, win_regedit
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| compare_key | Значение по умолчанию: нет значения по умолчанию | Ключ родительского узла для сравнения содержимого реестра с содержимым файла. Должен находиться в части реестра HKLM или HKCU. Используйте путь в стиле PS-Drive, например, HKLM:\SOFTWARE, а не HKEY_LOCAL_MACHINE\SOFTWARE. Если параметр не указан или ключ реестра не найден, сравнение не будет выполнено, и модуль сообщит об изменениях. |
| path обязательно | Значение по умолчанию: нет значения по умолчанию | Полный путь, включая имя файла, к файлу реестра на удаленном компьютере, который необходимо объединить |
Примечания
Примечание
- Организуйте свои файлы реестра так, чтобы они содержали единственный корневой ключ реестра, если вы хотите использовать функциональность compare_to. Данный модуль не принуждает параметры реестра к состоянию, описанному в файле. Если параметры реестра были изменены внешне, модуль объединит содержимое файла, но продолжит сообщать о различиях при последующих запусках. Чтобы принудительно изменить реестр, используйте win_regedit со значением state=absent перед использованием win_regmerge.
Примеры
# Merge in a registry file without comparing to current registry
# Note that paths using / to separate are preferred as they require less special handling than \
- win_regmerge:
path: C:/autodeploy/myCompany-settings.reg
# Compare and merge registry file
- 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.5/modules/win_regmerge_module.html
