ansible.builtin.udm_group (v2.9.27) — module

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

This module allows to manage user groups on a univention corporate server (UCS). It uses the python API of the UCS to create a new object or edit it.

Requirements

• Python >= 2.6

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Create a POSIX group
- udm_group:
    name: g123m-1A

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# 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)
- udm_group:
    name: g123m-1A
    subpath: 'cn=classes,cn=students,cn=groups'
    ou: school

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# or
- udm_group:
    name: g123m-1A
    position: 'cn=classes,cn=students,cn=groups,ou=school,dc=school,dc=example,dc=com'

Inputs

    
ou:
    description:
    - LDAP OU, e.g. school for LDAP OU C(ou=school,dc=example,dc=com).
    required: false

name:
    description:
    - Name of the posix group.
    required: true

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Whether the group is present or not.
    required: false

subpath:
    description:
    - Subpath inside the OU, e.g. C(cn=classes,cn=students,cn=groups).
    required: false

position:
    description:
    - define the whole ldap position of the group, e.g. C(cn=g123m-1A,cn=classes,cn=schueler,cn=groups,ou=schule,dc=example,dc=com).
    required: false

description:
    description:
    - Group description.
    required: false