Documentation

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 flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Maintenance

This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Core Team, see here.

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.