ansible.windows.win_regedit – Добавление, изменение или удаление ключей и значений реестра

Примечание

Этот плагин входит в сборку ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows

Для использования в книге задач укажите: ansible.windows.win_regedit

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

Описание

Добавление, изменение или удаление ключей и значений реестра.
Дополнительная информация о реестре Windows из Википедии https://en.wikipedia.org/wiki/Windows_Registry.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
data raw		Значение записи реестра `name` в `path` Если не указано, значение для свойства будет равно null для соответствующего `type` Бинарные и None данные должны быть представлены в виде yaml-массива байтов или в виде значений, разделенных запятыми. Простой способ сгенерировать это - запустить `regedit.exe` и использовать опцию export для сохранения значений реестра в файл. В экспортированном файле бинарное значение будет выглядеть как `hex:be,ef,be,ef`, префикс `hex:` необязателен. Значения DWORD и QWORD должны быть представлены либо десятичным числом, либо шестнадцатеричным значением. Значения multistring должны передаваться в виде списка. См. примеры для получения более подробной информации о формате этих данных.
delete_key boolean	Варианты: no да ←	Если `state` равно 'absent', то будет удалён весь ключ. Если `no`, то будет очищено только свойство '(Default)' для этого ключа.
hive path		Путь к ключу hive, например C:\Users\Default\NTUSER.DAT, для загрузки в реестр. Этот hive загружается в ключ HKLM:\ANSIBLE, который затем может использоваться в name как любой другой путь. Это можно использовать для загрузки hive реестра профиля пользователя по умолчанию или любого другого hive, сохранённого в виде файла. Для использования этой функции пользователю необходимо включить привилегии `SeRestorePrivilege` и `SeBackupPrivilege`
name string		Имя записи реестра в параметрах `path` Если не указано или пусто, то используется свойство '(Default)' ключа. псевдонимы: entry, value
path string / required		Имя пути реестра. Должен находиться в одном из следующих hive реестра: HKCC, HKCR, HKCU, HKLM, HKU. псевдонимы: key
state string	Варианты: absent present ←	Состояние записи реестра.
type string	Варианты: none binary dword expandstring multistring string ← qword	Тип данных значения реестра. псевдонимы: datatype

Примечания

Примечание

Режим проверки -C/--check и вывод различий -D/--diff поддерживаются, чтобы вы могли протестировать каждое изменение по отношению к активной конфигурации до применения изменений.
Следует быть осторожным, так как некоторые hive реестра (HKEY_USERS в частности) не позволяют создавать новые пути реестра в корневой папке.

См. также

ansible.windows.win_reg_stat: Официальная документация по модулю ansible.windows.win_reg_stat.
ansible.windows.win_regmerge: Официальная документация по модулю ansible.windows.win_regmerge.

Примеры

- name: Create registry path MyCompany
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany

- name: Add or update registry path MyCompany, with entry 'hello', and containing 'world'
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: world

- name: Add or update registry path MyCompany, with dword entry 'hello', and containing 1337 as the decimal value
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: 1337
    type: dword

- name: Add or update registry path MyCompany, with dword entry 'hello', and containing 0xff2500ae as the hex value
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: 0xff2500ae
    type: dword

- name: Add or update registry path MyCompany, with binary entry 'hello', and containing binary data in hex-string format
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: hex:be,ef,be,ef,be,ef,be,ef,be,ef
    type: binary

- name: Add or update registry path MyCompany, with binary entry 'hello', and containing binary data in yaml format
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: [0xbe,0xef,0xbe,0xef,0xbe,0xef,0xbe,0xef,0xbe,0xef]
    type: binary

- name: Add or update registry path MyCompany, with expand string entry 'hello'
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: '%appdata%\local'
    type: expandstring

- name: Add or update registry path MyCompany, with multi string entry 'hello'
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    data: ['hello', 'world']
    type: multistring

- name: Disable keyboard layout hotkey for all users (changes existing)
  ansible.windows.win_regedit:
    path: HKU:\.DEFAULT\Keyboard Layout\Toggle
    name: Layout Hotkey
    data: 3
    type: dword

- name: Disable language hotkey for current users (adds new)
  ansible.windows.win_regedit:
    path: HKCU:\Keyboard Layout\Toggle
    name: Language Hotkey
    data: 3
    type: dword

- name: Remove registry path MyCompany (including all entries it contains)
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    state: absent
    delete_key: yes

- name: Clear the existing (Default) entry at path MyCompany
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    state: absent
    delete_key: no

- name: Remove entry 'hello' from registry path MyCompany
  ansible.windows.win_regedit:
    path: HKCU:\Software\MyCompany
    name: hello
    state: absent

- name: Change default mouse trailing settings for new users
  ansible.windows.win_regedit:
    path: HKLM:\ANSIBLE\Control Panel\Mouse
    name: MouseTrails
    data: 10
    type: str
    state: present
    hive: C:\Users\Default\NTUSER.dat

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращённое значение	Описание
data_changed boolean	success	Изменились ли данные в значении реестра при этом вызове.
data_type_changed boolean	success	Изменился ли тип данных значения реестра при этом вызове. Пример: True

Авторы

Adam Keech (@smadam813)
Josh Ludwig (@joshludwig)
Jordan Borean (@jborean93)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/windows/win_regedit_module.html