win_group – Add and remove local groups

New in version 1.7.

Synopsis

• Add and remove local groups.
• For non-Windows targets, please use the group module instead.

Parameters

Parameter	Choices/Defaults	Comments
description -		Description of the group.
name - / required		Name of the group.
state -	Choices: absent present ←	Create or remove the group.

Notes

Note

• For non-Windows targets, please use the group module instead.

Examples

- name: Create a new group
  win_group:
    name: deploy
    description: Deploy Group
    state: present

- name: Remove a group
  win_group:
    name: deploy
    state: absent

Status

• This module is guaranteed to have no backward incompatible interface changes going forward. [stableinterface]
• This module is maintained by the Ansible Core Team. [core]

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

• Chris Hoffman (@chrishoffman)

Hint

If you notice any issues in this documentation you can edit this document to improve it.