win_group_membership - Управление членством в локальных группах Windows

Новое в версии 2.4.

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

Описание

Позволяет добавлять и удалять локальных, служебных и доменных пользователей и доменных групп в локальную группу.

Параметры

параметр	обязательно	по умолчанию	выбор	комментарии
members	да			Список членов, которые должны присутствовать/отсутствовать в группе. Принимает локальных пользователей в виде имени пользователя, .\имя_пользователя и ИМЯ_СЕРВЕРА\имя_пользователя. Принимает доменных пользователей и группы в виде ДОМЕН\имя_пользователя и имя_пользователя@ДОМЕН. Принимает служебных пользователей в виде NT AUTHORITY\имя_пользователя.
name	да			Имя локальной группы, членство в которой нужно управлять.
state	нет	present	present absent	Желаемое состояние членов в группе.

Примеры

- 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`; пусто, если члены не добавлялись.	успех и C(state) равно C(present)	список	['NewLocalAdmin', 'DOMAIN\\TestUser']
members	Список всех членов локальной группы после завершения; пусто, если группа не содержит членов.	успех	список	['DOMAIN\\TestUser', 'NewLocalAdmin']
name	Имя целевой локальной группы.	всегда	строка	Administrators
removed	Список членов, удаленных, когда `state` равно `absent`; пусто, если члены не удалялись.	успех и C(state) равно C(absent)	список	['DOMAIN\\TestGroup', 'NT AUTHORITY\\SYSTEM']

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Для помощи в разработке модулей, если у вас есть такое желание, ознакомьтесь с Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

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