Модуль community.general.udm_group — управление группой POSIX

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать её в плейбуке, укажите: community.general.udm_group.

Краткое описание
Параметры
Атрибуты
Примеры

Краткое описание

Этот модуль позволяет управлять группами пользователей на корпоративном сервере Univention (UCS). Он использует API UCS на Python для создания нового объекта или его редактирования.

Параметры

Параметр	Комментарии
description string	Описание группы.
name string / обязательный	Имя группы POSIX.
ou string	Подразделение LDAP, например `school` для подразделения LDAP `ou=school,dc=example,dc=com`. По умолчанию: `""`
position string	Укажите полное расположение группы в LDAP, например `cn=g123m-1A,cn=classes,cn=schueler,cn=groups,ou=schule,dc=example,dc=com`. По умолчанию: `""`
state string	Должна ли группа существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
subpath string	Подпуть внутри подразделения, например `cn=classes,cn=students,cn=groups`. По умолчанию: `"cn=groups"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Можно запускать в режиме `check_mode` и получать прогноз изменения состояния без изменения целевого объекта.
diff_mode	Поддержка: частичная	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примеры

- name: Create a POSIX group
  community.general.udm_group:
    name: g123m-1A

# Create a POSIX group with the exact DN
# C(cn=g123m-1A,cn=classes,cn=students,cn=groups,ou=school,dc=school,dc=example,dc=com)
- name: Create a POSIX group with a DN
  community.general.udm_group:
    name: g123m-1A
    subpath: 'cn=classes,cn=students,cn=groups'
    ou: school

# or
- name: Create a POSIX group with a DN
  community.general.udm_group:
    name: g123m-1A
    position: 'cn=classes,cn=students,cn=groups,ou=school,dc=school,dc=example,dc=com'

Авторы

keachi (@keachi)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/udm_group_module.html