win_regmerge — Объединяет содержимое файла реестра в реестр Windows
Новое в версии 2.1.
Описание
- Оборачивает команду reg.exe для импорта содержимого файла реестра.
- Подходит для использования с файлами реестра, созданными с помощью win_template.
- Файлы реестра Windows имеют определенный формат и должны быть правильно сформированы с использованием символов перевода строки с возвратом каретки и перевода строки, в противном случае они не будут объединены.
- Файлы экспортированного реестра часто начинаются с маркера порядка байтов, который необходимо удалить, если файл должен быть шаблонизирован с помощью win_template.
- Формат файла реестра описан по адресу https://support.microsoft.com/ru-ru/kb/310516
- См. также win_template, win_regedit
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| compare_key | Родительский ключ для сравнения содержимого реестра с содержимым файла. Должен находиться в части реестра HKLM или HKCU. Используйте путь в стиле PS-привода, например, HKLM:\SOFTWARE, а не HKEY_LOCAL_MACHINE\SOFTWARE. Если не указано или ключ реестра не найден, сравнение не будет выполнено, и модуль сообщит об изменениях. | |
| path обязательно | Полный путь, включая имя файла, к файлу реестра на удаленной машине для объединения |
Примечания
Примечание
- Организуйте файлы реестра так, чтобы они содержали один корневой ключ реестра, если вы хотите использовать функциональность сравнения. Этот модуль не принуждает параметры реестра к состоянию, описанному в файле. Если параметры реестра были изменены внешне, модуль объединит содержимое файла, но продолжит сообщать о различиях при последующих запусках. Чтобы принудительно изменить реестр, используйте win_regedit со значением state=absent перед использованием win_regmerge.
Примеры
- 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 логическое | при предоставлении ключа сравнения и выполнении сравнения | Выполнено ли сравнение между реестром и файлом Пример: True |
| difference_count целое число | изменённый | Количество различий между реестром и файлом Пример: 1 |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом 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.6/modules/win_regmerge_module.html
