Note
This plugin is part of the ansible.windows collection (version 1.7.3).
You might already have this collection installed if you are using the ansible
package. It is not included in ansible-core
. To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install ansible.windows
.
To use it in a playbook, specify: ansible.windows.win_group
.
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 ansible.builtin.group module.
The official documentation on the community.windows.win_domain_group module.
The official documentation on the ansible.windows.win_group_membership module.
- name: Create a new group ansible.windows.win_group: name: deploy description: Deploy Group state: present - name: Remove a group ansible.windows.win_group: name: deploy state: absent
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ansible/windows/win_group_module.html