group – Add or remove groups¶
Synopsis¶
Manage presence of groups on a host.
For Windows targets, use the win_group module instead.
Requirements¶
The below requirements are needed on the host that executes this module.
groupadd
groupdel
groupmod
Parameters¶
See Also¶
See also
- user – Manage user accounts
The official documentation on the user module.
- win_group – Add and remove local groups
The official documentation on the win_group module.
Examples¶
- name: Ensure group "somegroup" exists
group:
name: somegroup
state: present
Status¶
This module is guaranteed to have backward compatible interface changes going forward. [stableinterface]
This module is maintained by the Ansible Core Team. [core]
Red Hat Support¶
More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.