win_domain_group_membership – Управление членством в группах домена Windows

Новая в версии 2.8.

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

Описание

Позволяет добавлять и удалять пользователей и группы домена в/из группы домена.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
domain_password строка		Пароль для username.
domain_server строка		Указывает экземпляр Active Directory Domain Services, к которому необходимо подключиться. Может быть в виде FQDN или имени NetBIOS. Если не указано, значение основано на домене компьютера, на котором выполняется PowerShell.
domain_username строка		Имя пользователя для взаимодействия с AD. Если не указано, вместо него будет использоваться пользователь Ansible, используемый для входа в систему при использовании CredSSP или Kerberos с делегированием учетных данных.
members список / обязательно		Список членов, которые должны быть присутствовать/отсутствовать в группе. Указанные имена должны быть SamAccountName пользователя, группы, учетной записи службы или компьютера. Для компьютеров необходимо добавить "$" после имени; например, для добавления "Mycomputer" в группу используйте "Mycomputer$" в качестве члена.
name строка / обязательно		Имя группы домена, для которой необходимо управлять членством.
state строка	Варианты: absent present ← pure	Требуемое состояние членов в группе. Когда `state` равно `pure`, будут существовать только указанные члены, а все другие существующие члены, не указанные в списке, будут удалены.

См. также

win_domain_user – Управление учетными записями пользователей Windows Active Directory: Официальная документация по модулю win_domain_user.
win_domain_group – Создание, изменение или удаление групп домена: Официальная документация по модулю win_domain_group.

Примеры

- name: Add a domain user/group to a domain group
  win_domain_group_membership:
    name: Foo
    members:
      - Bar
    state: present

- name: Remove a domain user/group from a domain group
  win_domain_group_membership:
    name: Foo
    members:
      - Bar
    state: absent

- name: Ensure only a domain user/group exists in a domain group
  win_domain_group_membership:
    name: Foo
    members:
      - Bar
    state: pure

- name: Add a computer to a domain group
  win_domain_group_membership:
    name: Foo
    members:
      - DESKTOP$
    state: present

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

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

Ключ	Возвращаемое значение	Описание
added список	успех и `state` равно `present` или `pure`	Список членов, добавленных при `state` равно `present` или `pure`; пустой, если члены не добавлены. Пример: ['ИмяПользователя', 'ИмяГруппы']
members список	успех	Список всех членов группы домена по завершении; пустой, если группа не содержит членов. Пример: ['ИмяПользователя', 'ИмяГруппы']
name строка	всегда	Имя целевой группы домена. Пример: АдминистраторыДомена
removed список	успех и `state` равно `absent` или `pure`	Список членов, удаленных при `state` равно `absent` или `pure`; пустой, если члены не удалены. Пример: ['ИмяПользователя', 'ИмяГруппы']

Статус

Не гарантируется обратная совместимость этого модуля. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.8/modules/win_domain_group_membership_module.html