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

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.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_group_module.html