Set-Acl

Set-Acl [-Caminho] <string[]> [-AclObject] <ObjectSecurity> [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

C:\PS>$DogACL = get-acl c:\dog.txt

C:\PS>set-acl -path C:\cat.txt -AclObject $DogACL

Descrição
-----------
Esses comandos copiam os valores do descritor de segurança do arquivo Dog.txt para o descritor de segurança do arquivo Cat.txt. Quando os comandos estiverem completos, os descritores de segurança dos arquivos Dog.txt e Cat.txt serão idênticos.

O primeiro comando usa o cmdlet Get-Acl para obter o descritor de segurança do arquivo Dog.txt. O operador de atribuição (=) armazena o descritor de segurança no valor da variável $DogACL. 

O segundo comando usa Set-Acl para alterar os valores na ACL de Cat.txt para os valores em $DogACL.

O valor do parâmetro Path é o caminho para o arquivo Cat.txt. O valor do parâmetro AclObject é a ACL de modelo, neste caso, a ACL de Dog.txt quando foi salva na variável $DogACL.

C:\PS>get-acl c:\dog.txt | set-acl -path C:\cat.txt

Descrição
-----------
Esse comando é quase igual ao comando do exemplo anterior, exceto pelo fato de ele usar um operador de pipeline para enviar o descritor de segurança recuperado em um comando Get-Acl para um comando Set-Acl.

O primeiro comando usa o cmdlet Get-Acl para obter o descritor de segurança do arquivo Dog.txt. O operador de pipeline (|) transmite um objeto que representa o descritor de segurança Dog.txt para o comando Set-Acl.

O segundo comando usa Set-Acl para aplicar o descritor de segurança do arquivo Dog.txt a Cat.txt. Quando o comando estiver completo, as ACLs dos arquivos Dog.txt e Cat.txt serão idênticas.

C:\PS>$newACL = get-acl file0.txt

C:\PS>get-childitem c:\temp -recurse -include *.txt -force | set-acl -aclobject $newacl

Descrição
-----------
Esses comandos aplicam os descritores de segurança no arquivo File0.txt a todos os arquivos de texto no diretório C:\Temp e a todos os seus subdiretórios.

O primeiro comando obtém o descritor de segurança do arquivo File0.txt, localizado no diretório atual, e usa o operador de atribuição (=) para armazená-lo na variável $newACL.

O primeiro comando no pipeline usa o cmdlet Get-ChildItem para obter todos os arquivos de texto no diretório C:\Temp. O parâmetro Recurse estende o comando a todos os subdiretórios de C:\temp. O parâmetro Include limita os arquivos recuperados para aqueles com a extensão de nome do arquivo ".txt". O parâmetro Force obtém arquivos ocultos, que, de outra forma, seriam excluídos. (Não é possível usar "c:\temp\*.txt", pois o parâmetro Recurse funciona em diretórios, não em arquivos.)

O operador de pipeline (|) envia os objetos que representam os arquivos recuperados para o comando Set-Acl, o qual aplica o descritor de segurança no parâmetro AclObject a todos os arquivos contidos no pipeline.

Na prática, é melhor usar o parâmetro Whatif com todos os comandos Set-Acl que podem afetar mais de um recurso. Neste caso, o segundo comando no pipeline seria "set-acl -aclobject $newacl -whatif". Esse comando lista os arquivos que seriam afetados pelo comando. Depois de rever o resultado, você pode executar o comando novamente sem o parâmetro Whatif.