udm_group – Manage of the posix group
Synopsis
- 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
The below requirements are needed on the host that executes this module.
- Python >= 2.6
 
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
|   description    -    |    Group description.   |  |
|   name    - / required    |    Name of the posix group.   |  |
|   ou    -    |    LDAP OU, e.g. school for LDAP OU   ou=school,dc=example,dc=com. |  |
|   position    -    |    define the whole ldap position of the group, e.g.   cn=g123m-1A,cn=classes,cn=schueler,cn=groups,ou=schule,dc=example,dc=com. |  |
|   state    -    |   
  |    Whether the group is present or not.   |  
|   subpath    -    |    Subpath inside the OU, e.g.   cn=classes,cn=students,cn=groups. |  
Examples
# Create a POSIX group
- 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)
- udm_group:
    name: g123m-1A
    subpath: 'cn=classes,cn=students,cn=groups'
    ou: school
# or
- udm_group:
    name: g123m-1A
    position: 'cn=classes,cn=students,cn=groups,ou=school,dc=school,dc=example,dc=com'
   Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
 - This module is maintained by the Ansible Community. [community]
 
Authors
- Tobias Rüetschi (@keachi)
 
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
    © 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.9/modules/udm_group_module.html