mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
25 lines
1.5 KiB
ReStructuredText
25 lines
1.5 KiB
ReStructuredText
|
.. _group:
|
||
|
|
|
||
|
|
group
|
||
|
|
`````
|
||
|
|
|
||
|
|
Adds or removes groups.
|
||
|
|
|
||
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
||
|
|
| parameter | required | default | comments |
|
||
|
|
+====================+==========+=========+============================================================================+
|
||
|
|
| name | yes | | name of the group |
|
||
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
||
|
|
| gid | | | optional git to set for the group |
|
||
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
||
|
|
| state | | present | 'absent' or 'present' |
|
||
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
||
|
|
| system | | no | if 'yes', indicates that the group being created is a system group. |
|
||
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
||
|
|
|
||
|
|
To control members of the group, see the users resource.
|
||
|
|
|
||
|
|
Example action from Ansible :doc:`playbooks`::
|
||
|
|
|
||
|
|
group name=somegroup state=present
|