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

Parameter Choices/Defaults Comments
gid
Optional GID to set for the group.
name
required
Name of the group to manage.
state
    Choices:
  • absent
  • present ←
Whether the group should be present or not on the remote host.
system
    Choices:
  • no ←
  • yes
If yes, indicates that the group created is a system group.

Notes

Note

  • For Windows targets, use the win_group module instead.

Examples

- name: Ensure group "somegroup" exists
  group:
    name: somegroup
    state: present

Status

This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Support

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author

  • Stephen Fromm (@sfromm)

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.5/modules/group_module.html