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-Drive, например HKLM:\SOFTWARE, а не HKEY_LOCAL_MACHINE\SOFTWARE. Если параметр не указан или ключ реестра не найден, сравнение не будет выполнено, и модуль сообщит о изменениях. | |
| path | да | нет | Полный путь, включая имя файла, к файлу реестра на удалённой машине, который нужно объединить |
Примеры
# 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 | найден ли родительский ключ реестра для сравнения | при отсутствии ключа сравнения в реестре | логическое | False |
| compared | выполнялось ли сравнение между реестром и файлом | при предоставлении ключа сравнения и попытке сравнения | логическое | True |
| difference_count | количество различий между реестром и файлом | при изменении | целое | 1 |
Примечания
Примечание
- Организуйте файлы реестра так, чтобы они содержали один корневой ключ реестра, если вы хотите использовать функциональность сравнения. Этот модуль не заставляет настройки реестра быть в состоянии, описанном в файле. Если настройки реестра были изменены внешним образом, модуль объединит содержимое файла, но продолжит сообщать о различиях при последующих запусках. Чтобы принудительно изменить реестр, используйте win_regedit со значением state=absent перед использованием win_regmerge.
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Справочная информация по сообществу и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_regmerge_module.html
