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; пустой, если члены не были добавлены.Пример: ['SERVERNAME\\NewLocalAdmin', 'DOMAIN\\TestUser'] |
| members список | успех | Список всех членов локальной группы после завершения; пустой, если группа не содержит членов. Пример: ['DOMAIN\\TestUser', 'SERVERNAME\\NewLocalAdmin'] |
| name строка | всегда | Имя целевой локальной группы. Пример: Administrators |
| removed список | успех и state равен absent
| Список удаленных членов, когда state равен absent; пустой, если члены не были удалены.Пример: ['DOMAIN\\TestGroup', 'NT AUTHORITY\\SYSTEM'] |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/win_group_membership_module.html
