Displays or modifies discretionary access control lists (DACLs) on specified files and applies stored DACLs to files in specified directories.
Note: This command replaces the deprecated cacls command.
Syntax
icacls name [/save aclfile] [/setowner user] [/findsid Sid] [/verify] [/reset] [/T] [/C] [/L] [/Q]
icacls name [/grant[:r] Sid:perm[...]] [/deny Sid:perm [...]] [/remove[:g|:d]] Sid[...]]] [/setintegritylevel Level:policy[...]] [/T] [/C] [/L] [/Q]
icacls directory [/substitute SidOld SidNew [...]] [/restore aclfile] [/C] [/L] [/Q]
Parameters
| Parameter | Description |
|---|---|
| :::no-loc text="<name>"::: | Specifies the file for which to display or modify DACLs. |
| :::no-loc text="<directory>"::: | Specifies the directory for which to display or modify DACLs. |
| :::no-loc text="/t"::: | Performs the operation on all specified files in the current directory and its subdirectories. |
| :::no-loc text="/c"::: | Continues the operation even if file errors occur. Error messages are still shown. |
| :::no-loc text="/l"::: | Performs the operation on a symbolic link instead of its destination. |
| :::no-loc text="/q"::: | Suppresses success messages. |
| :::no-loc text="/save <ACLfile>"::: | Stores DACLs for all matching files into an access control list (ACL) file for later use with /restore. |
| :::no-loc text="/setowner <user>"::: | Changes the owner of all matching files to the specified user. |
| :::no-loc text="/findsid <sid>"::: | Finds all matching files that contain a DACL explicitly mentioning the specified security identifier (SID). |
| :::no-loc text="/verify"::: | Finds all files with ACLs that aren't canonical or have lengths inconsistent with access control entry (ACE) counts. |
| :::no-loc text="/reset"::: | Replaces ACLs with default inherited ACLs for all matching files. |
| :::no-loc text="/grant[:r] <sid>:<perm>"::: | Grants specified user access rights. Permissions replace previously granted explicit permissions. Not adding :r means that permissions are added to any previously granted explicit permissions. |
| :::no-loc text="/deny <sid>:<perm>"::: | Explicitly denies specified user access rights. An explicit deny ACE is added for the stated permissions and the same permissions in any explicit grant are removed. |
| :::no-loc text="/remove: g | d <sid>"::: | Removes all occurrences of the specified SID from the DACL. This command can also use:<li>g - Removes all occurrences of granted rights to the specified SID</li><li>d - Removes all occurrences of denied rights to the specified SID |
| :::no-loc text="/setintegritylevel <perm><level>"::: | Explicitly adds an integrity ACE to all matching files. The level can be specified as:<li>l - Low</li><li>m - Medium</li><li>h - High</li></ul>Inheritance options for the integrity ACE may precede the level and are applied only to directories. |
| :::no-loc text="/substitute <sidold> <sidnew>"::: | Replaces an existing SID (sidold) with a new SID (sidnew). Requires using with the <directory> parameter. |
| :::no-loc text="/restore <ACLfile> /c | /l | /q"::: | Applies stored DACLs from <ACLfile> to files in the specified directory. Requires using with the <directory> parameter. |
| :::no-loc text="/inheritancelevel: e | d | r"::: | Sets the inheritance level, which can be:<li>e - Enables inheritance</li><li>d - Disables inheritance and copies the ACEs</li><li>r - Disables inheritance and removes only inherited ACEs</li></ul> |
Remarks
-
SIDs may be in either numerical or friendly name form. If you use a numerical form, affix the wildcard character * to the beginning of the SID.
-
This command preserves the canonical order of ACE entries as:
-
Explicit denials
-
Explicit grants
-
Inherited denials
-
Inherited grants
-
-
The
<perm>option is a permission mask that can be specified for basic rights, advanced rights, or inheritance rights:-
A sequence of simple rights (basic permissions) without the need to use parenthesis:
- N - No access
- F - Full access
- M - Modify access
- RX - Read and execute access
- R - Read-only access
- W - Write-only access
- D - Delete access
-
A comma-separated list of specific rights (advanced permissions) which must use parenthesis:
- DE - Delete
- RC - Read control (read permissions)
- WDAC - Write DAC (change permissions)
- WO - Write owner (take ownership)
- S - Synchronize
- AS - Access system security
- MA - Maximum allowed
- GR - Generic read
- GW - Generic write
- GE - Generic execute
- GA - Generic all
- RD - Read data/list directory
- WD - Write data/add file
- AD - Append data/add subdirectory
- REA - Read extended attributes
- WEA - Write extended attributes
- X - Execute/traverse
- DC - Delete child
- RA - Read attributes
- WA - Write attributes
-
A sequence of inheritance rights which must use parenthesis:
- (I) - Inherit. ACE inherited from the parent container.
- (OI) - Object inherit. Objects in this container inherits this ACE. Applies only to directories.
- (CI) - Container inherit. Containers in this parent container inherits this ACE. Applies only to directories.
- (IO) - Inherit only. ACE inherited from the parent container, but doesn't apply to the object itself. Applies only to directories.
- (NP) - Don't propagate inherit. ACE inherited by containers and objects from the parent container, but doesn't propagate to nested containers. Applies only to directories.
-
Examples
To save the DACLs for all files in the C:\Windows directory and its subdirectories to the ACLFile file, type:
icacls c:\windows\* /save aclfile /t
To restore the DACLs for every file within ACLFile that exists in the C:\Windows directory and its subdirectories, type:
icacls c:\windows\ /restore aclfile
To grant the user User1 Delete and Write DAC permissions to a file named Test1, type:
icacls test1 /grant User1:(d,wdac)
To grant the user defined by SID S-1-1-0 Delete and Write DAC permissions to a file named TestFile, type:
icacls TestFile /grant *S-1-1-0:(d,wdac)
To apply a high integrity level to a directory and ensure that both its files and subdirectories inherit this level, type:
icacls "myDirectory" /setintegritylevel (CI)(OI)H
Related links
Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
