win_group - Add and remove local groups¶

New in version 1.7.

Synopsis
Parameters
Notes
Examples
Status
Maintenance
- Support
- Author

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.