community.windows.win_domain_group_membership – Manage Windows domain group membership¶
Note
This plugin is part of the community.windows collection (version 1.3.0).
To install it use: ansible-galaxy collection install community.windows
.
To use it in a playbook, specify: community.windows.win_domain_group_membership
.
Parameters¶
See Also¶
See also
- community.windows.win_domain_user
The official documentation on the community.windows.win_domain_user module.
- community.windows.win_domain_group
The official documentation on the community.windows.win_domain_group module.
Examples¶
- name: Add a domain user/group to a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- Bar
state: present
- name: Remove a domain user/group from a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- Bar
state: absent
- name: Ensure only a domain user/group exists in a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- Bar
state: pure
- name: Add a computer to a domain group
community.windows.win_domain_group_membership:
name: Foo
members:
- DESKTOP$
state: present
- name: Add a domain user/group from another Domain in the multi-domain forest to a domain group
community.windows.win_domain_group_membership:
domain_server: DomainAAA.cloud
name: GroupinDomainAAA
members:
- DomainBBB.cloud\UserInDomainBBB
state: Present
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
Marius Rieder (@jiuka)