win_group_membership - Управление членством в локальных группах Windows
Новая версия в версии 2.4.
Обзор
- Разрешает добавление и удаление локальных, сервисных и доменных пользователей и доменных групп из локальной группы.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| members обязательно | Список членов, присутствие/отсутствие которых в группе необходимо гарантировать. Принимает локальных пользователей в формате имя_пользователя, .\имя_пользователя и SERVERNAME\имя_пользователя. Принимает доменных пользователей и группы в формате DOMAIN\имя_пользователя и имя_пользователя@DOMAIN. Принимает сервисных пользователей в формате NT AUTHORITY\имя_пользователя. | |
| name обязательно | Имя локальной группы, членство в которой нужно управлять. | |
| state |
| Желаемое состояние членов в группе. |
Примеры
- name: Add a local and domain user to a local group
win_group_membership:
name: Remote Desktop Users
members:
- NewLocalAdmin
- DOMAIN\TestUser
state: present
- name: Remove a domain group and service user from a local group
win_group_membership:
name: Backup Operators
members:
- DOMAIN\TestGroup
- NT AUTHORITY\SYSTEM
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| added список | успех и state есть present
| Список добавленных членов, когда state равно present; пустой, если члены не добавлялись.Пример: ['НовыйЛокальныйАдмин', 'DOMAIN\\ТестовыйПользователь'] |
| members список | успех | Список всех членов локальной группы по завершении; пустой, если группа не содержит членов. Пример: ['DOMAIN\\ТестовыйПользователь', 'НовыйЛокальныйАдмин'] |
| name строка | всегда | Имя целевой локальной группы. Пример: Администраторы |
| removed список | успех и state есть absent
| Список удалённых членов, когда state равно absent; пустой, если члены не удалялись.Пример: ['DOMAIN\\ТестоваяГруппа', 'NT AUTHORITY\\SYSTEM'] |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Автор
- Andrew Saraceni (@andrewsaraceni)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 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_group_membership_module.html
