�
�Udac @ s4 i d d 6d g d 6d d 6Z d Z d Z d Z d S(
s 1.1t metadata_versiont previewt statust communityt supported_bys
---
module: win_group_membership
version_added: "2.4"
short_description: Manage Windows local group membership
description:
- Allows the addition and removal of local, service and domain users,
and domain groups from a local group.
options:
name:
description:
- Name of the local group to manage membership on.
type: str
required: yes
members:
description:
- A list of members to ensure are present/absent from the group.
- Accepts local users as .\username, and SERVERNAME\username.
- Accepts domain users and groups as DOMAIN\username and username@DOMAIN.
- Accepts service users as NT AUTHORITY\username.
- Accepts all local, domain and service user types as username,
favoring domain lookups when in a domain.
type: list
required: yes
state:
description:
- Desired state of the members in the group.
- C(pure) was added in Ansible 2.8.
- When C(state) is C(pure), only the members specified will exist,
and all other existing members not specified are removed.
type: str
choices: [ absent, present, pure ]
default: present
seealso:
- module: win_domain_group
- module: win_domain_membership
- module: win_group
author:
- Andrew Saraceni (@andrewsaraceni)
s,
- name: Add a local and domain user to a local group
win_group_membership:
name: Remote Desktop Users
members:
- NewLocalAdmin
- DOMAIN\TestUser
state: present
- name: Remove a domain group and service user from a local group
win_group_membership:
name: Backup Operators
members:
- DOMAIN\TestGroup
- NT AUTHORITY\SYSTEM
state: absent
- name: Ensure only a domain user exists in a local group
win_group_membership:
name: Remote Desktop Users
members:
- DOMAIN\TestUser
state: pure
sd
name:
description: The name of the target local group.
returned: always
type: str
sample: Administrators
added:
description: A list of members added when C(state) is C(present) or
C(pure); this is empty if no members are added.
returned: success and C(state) is C(present)
type: list
sample: ["SERVERNAME\\NewLocalAdmin", "DOMAIN\\TestUser"]
removed:
description: A list of members removed when C(state) is C(absent) or
C(pure); this is empty if no members are removed.
returned: success and C(state) is C(absent)
type: list
sample: ["DOMAIN\\TestGroup", "NT AUTHORITY\\SYSTEM"]
members:
description: A list of all local group members at completion; this is empty
if the group contains no members.
returned: success
type: list
sample: ["DOMAIN\\TestUser", "SERVERNAME\\NewLocalAdmin"]
N( t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURN( ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/windows/win_group_membership.pyt <module> s
)
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]