{"id":4051,"date":"2009-05-10T21:05:00","date_gmt":"2009-05-10T21:05:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2009\/05\/10\/copy-acl\/"},"modified":"2019-02-18T13:12:39","modified_gmt":"2019-02-18T20:12:39","slug":"copy-acl","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/copy-acl\/","title":{"rendered":"Copy-Acl"},"content":{"rendered":"

Today my wife told me about a problem on the family PC.  There were a bunch of PDF files in a directory that had the wrong permissions so my son couldn\u2019t access them.  She modified the ACL on one of them using Explorer and verified that that was the fix.  (This is from a test I ran)<\/p>\n

\"image\"<\/a> <\/p>\n

She then selected them all and tried to do it all at once but when she brought up the Properties, it didn\u2019t have the Security Page anymore:<\/p>\n

\"image\"<\/a> <\/p>\n

She wanted to know if there was some trick to set the ACLs all at once.  I told her that PowerShell could do that.  I showed her how to use Get-Acl and Set-Acl and she gave me a look like, \u201cyou expect me to remember that?\u201d and asked, \u201cwhy don\u2019t you just have a COPY-ACL\u2019 cmdlet.  I told her her how \u201cto ship is to choose\u201d but she wasn\u2019t having any of it.  She clearly thought I was an idiot for not having shipped Copy-Acl.  You know what \u2013 I totally get it.  As a user \u2013 who cares how tough it is to ship software at Microsoft?  All that matters is that you have a need and we either meet it or we don\u2019t.  Sadly that doesn\u2019t change the reality of what it takes to ship things at Microsoft but it does provide some energy to write\/share scripts.<\/p>\n

As such, I spent a few minutes and wrote Copy-Acl.  I hope you enjoy it.  I\u2019ve also attached it as a file to this blog.  <\/p>\n

Enjoy!<\/p>\n

Jeffrey Snover [MSFT]
Distinguished Engineer
Visit the Windows PowerShell Team blog at:    http:\/\/blogs.msdn.com\/PowerShell<\/a>
Visit the Windows PowerShell ScriptCenter at:  http:\/\/www.microsoft.com\/technet\/scriptcenter\/hubs\/msh.mspx<\/a><\/p>\n

 <\/p>\n

——————————————————————————————-<\/p>\n

 <\/p>\n

<#
.SYNOPSIS
Copy the ACL from one file to other files <\/font><\/p>\n

.DESCRIPTION
Takes a file and copies its ACL to one or more other files. <\/font><\/p>\n

.PARAMETER FromPath
Path of the File to get the ACL from. <\/font><\/p>\n

.PARAMETER Destination
Path to one or more files to copy the ACL to. <\/font><\/p>\n

.PARAMETER Passthru
Returns an object representing the security descriptor.  By default, this cmdlet does not generate any output. <\/font><\/p>\n

.INPUTS
You can Pipeline any object with a Property named "PSPath", "FullName" or "Destination". <\/font><\/p>\n

.EXAMPLE
PS> Copy-Acl Referencefile.txt (dir c:\\temp\\*xml) <\/font><\/p>\n

.EXAMPLE
PS> dir c:\\files *.xml -recurse | Copy-Acl ReferenceFile.txt <\/font><\/p>\n

.LINK
Get-Acl
Set-Acl <\/font><\/p>\n

.NOTES
Author:  Jeffrey Snover <\/font><\/p>\n

#>
#requires -Version 2.0
[CmdletBinding(SupportsShouldProcess=$true)]
param(
[Parameter(position=0,Mandatory=$true)]
[String]$FromPath, <\/font><\/p>\n

[Parameter(Position=1,Mandatory=$true,ValueFromPipelineByPropertyName=$true)]
[Alias("PSpath","fullname")]
[String[]]$Destination, <\/font><\/p>\n

[Parameter(Mandatory=$false)]
[Switch]$PassThru
)
Begin
{
    if (! (Test-Path $FromPath))
    {
        $ErrorRecord = New-Object System.Management.Automation.ErrorRecord  (
            (New-Object Exception "FromPath ($fromPath) does not point to an existing object"),
            "Copy-Acl.TestPath",
            "ObjectNotFound",
            $FromPath
         ) <\/font><\/p>\n

        $PSCmdlet.ThrowTerminatingError($ErrorRecord)
    }
    $acl = Get-Acl $FromPath
}
Process
{
    foreach ($Dest in @($Destination))
    {
        if ($pscmdlet.ShouldProcess($Dest))
        {
            Set-Acl -Path $Dest -AclObject $acl -Passthru:$PassThru
        }
    }
}<\/font><\/p>\n

<\/font><\/p>\n

Copy-Acl.ps1<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Today my wife told me about a problem on the family PC.  There were a bunch of PDF files in a directory that had the wrong permissions so my son couldn\u2019t access them.  She modified the ACL on one of them using Explorer and verified that that was the fix.  (This is from a test […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-4051","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell"],"acf":[],"blog_post_summary":"

Today my wife told me about a problem on the family PC.  There were a bunch of PDF files in a directory that had the wrong permissions so my son couldn\u2019t access them.  She modified the ACL on one of them using Explorer and verified that that was the fix.  (This is from a test […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4051","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=4051"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4051\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=4051"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=4051"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=4051"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}