mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
25 lines
1.5 KiB
ReStructuredText
25 lines
1.5 KiB
ReStructuredText
12 years ago
|
.. _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
|