Add and remove local groups.
For non-Windows targets, please use the group module instead.
Parameter | Choices/Defaults | Comments |
---|---|---|
description
string
|
Description of the group.
|
|
name
string
/ required
|
Name of the group.
|
|
state
string
|
|
Create or remove the group.
|
See also
The official documentation on the group module.
The official documentation on the win_domain_group module.
The official documentation on the win_group_membership module.
- name: Create a new group
win_group:
name: deploy
description: Deploy Group
state: present
- name: Remove a group
win_group:
name: deploy
state: absent
This module is guaranteed to have no backward incompatible interface changes going forward. [stableinterface]
This module is maintained by the Ansible Core Team. [core]
More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.
Chris Hoffman (@chrishoffman)
Hint
If you notice any issues in this documentation you can edit this document to improve it.