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 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 boolean | при отсутствии ключа сравнения в реестре | является ли родительский ключ реестра найденным для сравнения |
| compared boolean | при указании ключа сравнения и попытке сравнения | было ли выполнено сравнение между реестром и файлом Пример: True |
| 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.7/modules/win_regmerge_module.html
