community.general.udm_group 模块 – 管理 posix 用户组

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 Playbook 中使用它，请指定：community.general.udm_group。

概要

  • 此模块允许在 Univention Corporate Server (UCS) 上管理用户组。它使用 UCS 的 Python API 创建新对象或编辑它。

参数

参数

注释

description

字符串

组描述。

name

字符串 / 必需

posix 组的名称。

ou

字符串

LDAP OU，例如，对于 LDAP OU ou=school,dc=example,dc=com，使用 school。

默认值： ""

position

字符串

定义组的整个 LDAP 位置，例如 cn=g123m-1A,cn=classes,cn=schueler,cn=groups,ou=schule,dc=example,dc=com。

默认值： ""

state

字符串

该组是否存在。

选项

  • "present" ← (默认)

  • "absent"

subpath

字符串

OU 内的子路径，例如 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'

作者

  • Tobias Rüetschi (@keachi)