group

Collection: builtin

Full Name: parallax.builtin.group

Aliases: ansible.builtin.group, group

Synopsis

Manage group

Parameters

NameTypeRequiredDefaultDescription
namestringyesName of the group to manage
statestringpresentWhether the group should exist or not
gidintOptional GID to set for the group
systemboolfalseIndicates if group is a system group
forceboolfalseWhether to delete a group even if it is the primary group of a user
localboolfalseForces use of local command alternatives
non_uniqueboolfalseAllows changing group ID to non-unique value
gid_minintSets GID_MIN for group creation
gid_maxintSets GID_MAX for group creation

Example

- name: Example group task
  group:
    name: <your_name>