ansible.windows.win_group_membership – Управление членством в локальной группе Windows

Примечание

Этот плагин входит в сборку ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Чтобы использовать его в книге задач, укажите: ansible.windows.win_group_membership.

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
members список / элементы=строка / обязательный		Список членов, присутствие/отсутствие которых должно быть гарантировано в группе. Принимает локальных пользователей как .\username и SERVERNAME\username. Принимает доменных пользователей и группы как DOMAIN\username и username@DOMAIN. Принимает сервисных пользователей как NT AUTHORITY\username. Принимает все типы локальных, доменных и сервисных пользователей как username, отдавая предпочтение поиску по домену при работе в домене.
name строка / обязательный		Имя локальной группы, членство в которой нужно управлять.
state строка	Варианты: absent present ← pure	Желаемое состояние членов в группе. Когда `state` равно `pure`, только указанные члены будут существовать, а все другие существующие члены, не указанные в списке, будут удалены.

См. также

community.windows.win_domain_group: Официальная документация по модулю community.windows.win_domain_group.
ansible.windows.win_domain_membership: Официальная документация по модулю ansible.windows.win_domain_membership.
ansible.windows.win_group: Официальная документация по модулю ansible.windows.win_group.

Примеры

- name: Add a local and domain user to a local group
  ansible.windows.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
  ansible.windows.win_group_membership:
    name: Backup Operators
    members:
      - DOMAIN\TestGroup
      - NT AUTHORITY\SYSTEM
    state: absent

- name: Ensure only a domain user exists in a local group
  ansible.windows.win_group_membership:
    name: Remote Desktop Users
    members:
      - DOMAIN\TestUser
    state: pure

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

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

Ключ	Возвращаемое значение	Описание
added список / элементы=строка	успех и `state` равно `present`	Список членов, добавленных, когда `state` равно `present` или `pure`; пустой, если члены не были добавлены. Пример: ['SERVERNAME\\NewLocalAdmin', 'DOMAIN\\TestUser']
members список / элементы=строка	успех	Список всех членов локальной группы по завершении; пустой, если группа не содержит членов. Пример: ['DOMAIN\\TestUser', 'SERVERNAME\\NewLocalAdmin']
name строка	всегда	Имя целевой локальной группы. Пример: Administrators
removed список / элементы=строка	успех и `state` равно `absent`	Список членов, удаленных, когда `state` равно `absent` или `pure`; пустой, если члены не были удалены. Пример: ['DOMAIN\\TestGroup', '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.10/collections/ansible/windows/win_group_membership_module.html