Add-CxFilePermission

Namespace ComputerX.PowerShell

Inputs

System.String System.String[]

Outputs

System.Boolean

Adds an ACE to a file or directory DACL.

Examples

Authored help example

Example 1


Add-CxFilePermission -Path C:\\Data\\Report.txt -Identity DOMAIN\\Ops -Rights ReadAndExecute

Example 2


Add-CxFilePermission -Path C:\\Data -Identity @('DOMAIN\\Ops','DOMAIN\\Auditors') -Rights Modify -AccessType Deny -Inheritance ContainerInherit, ObjectInherit

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

Add-CxFilePermission -Path <string> -Identity <string[]> -Rights <ReadData> [-AccessType <Allow|Deny>] [-Inheritance <ContainerInherit|ObjectInherit|InheritOnly|NoPropagateInherit>] [<CommonParameters>]

Parameters

Path string requiredposition: 0pipeline: true (ByPropertyName): File system path to the target resource.
Identity string[] requiredposition: 1pipeline: true (ByValue, ByPropertyName): Account or security identifier (SID) to apply.
Rights FileSystemRights requiredposition: 2pipeline: falsevalues: 23: Access rights or permission mask to apply. Possible values: ReadData, ListDirectory, WriteData, CreateFiles, AppendData, CreateDirectories, ReadExtendedAttributes, WriteExtendedAttributes, ExecuteFile, Traverse, DeleteSubdirectoriesAndFiles, ReadAttributes, WriteAttributes, Delete, ReadPermissions, ChangePermissions, TakeOwnership, Synchronize, FullControl, Read, ReadAndExecute, Write, Modify; Possible values: ReadData, ListDirectory, WriteData, CreateFiles, AppendData, CreateDirectories, ReadExtendedAttributes, WriteExtendedAttributes, ExecuteFile, Traverse, DeleteSubdirectoriesAndFiles, ReadAttributes, WriteAttributes, Delete, ReadPermissions, ChangePermissions, TakeOwnership, Synchronize, FullControl, Read, ReadAndExecute, Write, Modify
AccessType AclAccessType optionalposition: 3pipeline: falsevalues: 2: Specifies whether access is Allowed or Denied. Possible values: Allow, Deny; Possible values: Allow, Deny
Inheritance AclInheritanceFlags optionalposition: 4pipeline: falsevalues: 4: Inheritance flags that control ACE propagation. Possible values: None, ContainerInherit, ObjectInherit, InheritOnly, NoPropagateInherit; Possible values: ContainerInherit, ObjectInherit, InheritOnly, NoPropagateInherit

Outputs

System.Boolean