The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
gid
integer
|
Optional GID to set for the group.
|
|
local
boolean
added in 2.6 |
|
Forces the use of "local" command alternatives on platforms that implement it.
This is useful in environments that use centralized authentication when you want to manipulate the local groups. (e.g. it uses
lgroupadd instead of groupadd ).This requires that these commands exist on the targeted host, otherwise it will be a fatal error.
|
name
string
/ required
|
Name of the group to manage.
|
|
non_unique
boolean
added in 2.8 |
|
This option allows to change the group ID to a non-unique value. Requires
gid .Not supported on macOS or BusyBox distributions.
|
state
string
|
|
Whether the group should be present or not on the remote host.
|
system
boolean
|
|
If yes, indicates that the group created is a system group.
|
See also
More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.
Hint
If you notice any issues in this documentation you can edit this document to improve it.