Documentation
PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.17
Documentation for other releases can be found by using the version selector in the top right of any doc page.group
Manage groups and group attributes.
Attributes
check_mode:
support: full
Parameters
| Parameter | Required | Type | Values | Description |
|---|---|---|---|---|
| gid | integer | Group ID (GID) of the group. | ||
| name | true | string | Name of the group to create, remove or modify. | |
| state | string | absent present |
Whether the group should exist or not. [default: "present"] |
|
| system | boolean | Create as system group (gid < 1000). [default: false] |
Example
- group:
name: docker
gid: 999
- group:
name: myservice
system: yes
- group:
name: oldgroup
state: absent