Gets the permissions (access control rules) for a path.
Get-Permissions [-Path] <String> [[-Identity] <String>] [-Inherited] [<CommonParameters>]
Permissions for a specific identity can also be returned. Access control entries are for a path's discretionary access control list.
To return inherited permissions, use the Inherited
switch. Otherwise, only non-inherited (i.e. explicit) permissions are returned.
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
Path | String | The path whose permissions (i.e. access control rules) to return. | true | false | |
Identity | String | The identity whose permissiosn (i.e. access control rules) to return. | false | false | |
Inherited | SwitchParameter | Return inherited permissions in addition to explicit permissions. | false | false |
System.Security.AccessControl.AccessRule.
Get-Permissions -Path C:\Windows
Returns System.Security.AccessControl.FileSystemAccessRule
objects for all the non-inherited rules on C:\windows
.
Get-Permissions -Path hklm:\Software -Inherited
Returns System.Security.AccessControl.RegistryAccessRule
objects for all the inherited and non-inherited rules on hklm:\software
.
Get-Permissions -Path C:\Windows -Idenity Administrators
Returns System.Security.AccessControl.FileSystemAccessRule
objects for all the Administrators'
rules on C:\windows
.