udm_group – Manage of the posix group
New in version 2.2.
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.8/modules/udm_group_module.html