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 Default:
None
Description of the group
name
required
Default:
None
Name of the group
state
    Choices:
  • present
  • absent
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 flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Support

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author

  • 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.5/modules/win_group_module.html