community.windows.win_domain_group_membership – Управление членством в группе домена Windows
Примечание
Этот плагин входит в коллекцию community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Для использования в плейбуке укажите: community.windows.win_domain_group_membership.
Описание
- Разрешает добавление и удаление пользователей и групп домена в/из группы домена.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| domain_password строка | Пароль для username. | |
| domain_server строка | Указывает экземпляр служб домена Active Directory, к которому следует подключиться. Может быть в формате FQDN или NetBIOS-имени. Если не указано, значение основано на домене компьютера, на котором выполняется PowerShell. | |
| domain_username строка | Имя пользователя, используемое при взаимодействии с AD. Если не задано, при использовании CredSSP или Kerberos с делегированием учетных данных будет использован пользователь Ansible, который использовался для входа. | |
| members список / элементы=строка / обязательно | Список членов, присутствие/отсутствие которых нужно гарантировать в группе. Указанные имена должны быть SamAccountName пользователя, группы, учетной записи службы или компьютера. Для компьютеров необходимо добавить "$" после имени; например, чтобы добавить "Mycomputer" в группу, используйте "Mycomputer$" как члена. Если объект члена находится в другом домене в многодоменном лесу, необходимо добавить домен и "\" перед именем. | |
| name строка / обязательно | Имя группы домена, членство в которой необходимо управлять. | |
| state строка |
| Требуемое состояние членов в группе. Когда state равно pure, только указанные члены будут существовать, а все другие существующие члены, не указанные, будут удалены. |
Примечания
Примечание
- Этот модуль необходимо запускать на хосте, на котором установлен модуль PowerShell ActiveDirectory.
См. также
См. также
- community.windows.win_domain_user
-
Официальная документация по модулю community.windows.win_domain_user.
- community.windows.win_domain_group
-
Официальная документация по модулю community.windows.win_domain_group.
Примеры
- name: Add a domain user/group to a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- Bar
state: present
- name: Remove a domain user/group from a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- Bar
state: absent
- name: Ensure only a domain user/group exists in a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- Bar
state: pure
- name: Add a computer to a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- DESKTOP$
state: present
- name: Add a domain user/group from another Domain in the multi-domain forest to a domain group
community.windows.win_domain_group_membership:
domain_server: DomainAAA.cloud
name: GroupinDomainAAA
members:
- DomainBBB.cloud\UserInDomainBBB
state: Present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| added список / элементы=строка | успех и state равно present или pure
| Список добавленных членов, когда state равно present или pure; пусто, если члены не добавлялись.Пример: ['ИмяПользователя', 'ИмяГруппы'] |
| members список / элементы=строка | успех | Список всех членов группы домена по завершении; пусто, если группа не содержит членов. Пример: ['ИмяПользователя', 'ИмяГруппы'] |
| name строка | всегда | Имя целевой группы домена. Пример: Domain-Admins |
| removed список / элементы=строка | успех и state равно absent или pure
| Список удалённых членов, когда state равно absent или pure; пусто, если члены не удалялись.Пример: ['ИмяПользователя', 'ИмяГруппы'] |
Авторы
- Marius Rieder (@jiuka)
© 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/community/windows/win_domain_group_membership_module.html
