how to use powershell 2.0 SET-ACL command
Set Access Control List permissions from on a file (or object).
Syntax
Set-Acl [-path] string[] [-aclObject] ObjectSecurity
[-Include String] [-Exclude String]
[-filter string] [-passThru] [-whatIf]
[-confirm] [-UseTransaction] [CommonParameters]
Key
-Path path
Path to the item to be changed {accepts wildcards}
If a security object is passed to Set-Acl (either via -AclObject
or by passing an object from Get-Acl), and -Path is omitted,
Set-Acl will use the path that is included in the security object.
-AclObject ObjectSecurity
An ACL with the desired property values.
Often the output of a Get-Acl command saved in a variable.
-Filter string
A filter in the provider's format or language.
The exact syntax of the filter (wildcard support etc) depends on the provider.
Filters are more efficient than -include/-exclude, because the provider
applies the filter when retrieving the objects, rather than having
PowerShell filter the objects after they are retrieved.
-include string
Include only the specified items from the Path. e.g. "May*"
This qualifies the -Path parameter and normally includes a wildcard.
-Exclude string
Omit the specified items from the Path e.g. "*SS64*"
This qualifies the -Path parameter and normally includes a wildcard.
-PassThru
Pass the object created by Set-Acl through the pipeline.
-WhatIf
Describe what would happen if you executed the command without
actually executing the command.
-Confirm
Prompt for confirmation before executing the command.
-UseTransaction
Include the command in the active transaction.
CommonParameters:
-Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
-OutBuffer -OutVariable.
Examples
Copy the security settings from Dog.txt to Cat.txt
PS C:\> $DogACL = get-acl c:\dog.txt
PS C:\> set-acl -path C:\cat.txt -AclObject $DogACL
PS C:\> set-acl -path C:\cat.txt -AclObject $DogACL
Or the same thing with a pipeline:
PS C:\> get-acl c:\dog.txt | set-acl -path C:\cat.txt
Apply the same $Dog ACL to all the files in C:\Temp\ and all of its subdirectories:
Apply the same $Dog ACL to all the files in C:\Temp\ and all of its subdirectories:
PS C:\> get-childitem c:\temp -recurse -force | set-acl -aclobject $DogACL -whatif
Comments
Post a Comment