ansible.windows.win_acl_inheritance module – Change ACL inheritance
Note
This module is part of the ansible.windows collection (version 2.5.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install ansible.windows
.
To use it in a playbook, specify: ansible.windows.win_acl_inheritance
.
Synopsis
Change ACL (Access Control List) inheritance and optionally copy inherited ACE’s (Access Control Entry) to dedicated ACE’s or vice versa.
Parameters
Parameter |
Comments |
---|---|
Path to be used for changing inheritance Support for registry keys have been added in |
|
For For Choices:
|
|
Specify whether to enable present or disable absent ACL inheritance. Choices:
|
See Also
See also
- ansible.windows.win_acl
Set file/directory/registry/certificate permissions for a system user or group.
- ansible.windows.win_file
Creates, touches or removes files or directories.
- ansible.windows.win_stat
Get information about Windows files.
Examples
- name: Disable inherited ACE's
ansible.windows.win_acl_inheritance:
path: C:\apache
state: absent
- name: Disable and copy inherited ACE's
ansible.windows.win_acl_inheritance:
path: C:\apache
state: absent
reorganize: true
- name: Enable and remove dedicated ACE's
ansible.windows.win_acl_inheritance:
path: C:\apache
state: present
reorganize: true
- name: Disable registry key inherited ACE's
ansible.windows.win_acl_inheritance:
path: HKLM:\SOFTWARE\Secrets
state: absent
- name: Disable and copy registry key inherited ACE's
ansible.windows.win_acl_inheritance:
path: HKLM:\SOFTWARE\Secrets
state: absent
reorganize: true
- name: Enable and remove registry key dedicated ACE's
ansible.windows.win_acl_inheritance:
path: HKLM:\SOFTWARE\Secrets
state: present
reorganize: true