Set-Acl

Set-Acl
    [-Path] <String[]>
    [-AclObject] <Object>
    [[-CentralAccessPolicy] <String>]
    [-ClearCentralAccessPolicy]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Set-Acl
    [-InputObject] <PSObject>
    [-AclObject] <Object>
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Set-Acl
    [-AclObject] <Object>
    [[-CentralAccessPolicy] <String>]
    -LiteralPath <String[]>
    [-ClearCentralAccessPolicy]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

O cmdlet Set-Acl altera o descritor de segurança de um item especificado, como um arquivo ou uma chave do Registro, para corresponder aos valores em um descritor de segurança fornecido.

Para usar Set-Acl, utilize o parâmetro Path ou InputObject para identificar o item do qual deseja alterar o descritor de segurança. Em seguida, use os parâmetros AclObject ou SecurityDescriptor para fornecer um descritor de segurança que tenha os valores que pretende aplicar. Set-Acl aplica o descritor de segurança fornecido. Ele usa o valor do parâmetro AclObject como um modelo e altera os valores no descritor de segurança do item para corresponder aos valores no parâmetro AclObject.

$DogACL = Get-Acl -Path "C:\Dog.txt"
Set-Acl -Path "C:\Cat.txt" -AclObject $DogACL

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 são concluídos, os descritores de segurança dos arquivos Dog.txt e Cat.txt sã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 do modelo, neste caso, a ACL de Dog.txt como salva na variável $DogACL.

Get-Acl -Path "C:\Dog.txt" | Set-Acl -Path "C:\Cat.txt"

Este comando é quase o mesmo que o comando no exemplo anterior, exceto que ele usa um operador de pipeline (|) para enviar o descritor de segurança de 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 (|) passa um objeto que representa o descritor de segurança Dog.txt para o cmdlet Set-Acl.

O segundo comando usa Set-Acl para aplicar o descritor de segurança de Dog.txt a Cat.txt. Quando o comando é concluído, as ACLs dos arquivos Dog.txt e Cat.txt são idênticas.

$NewAcl = Get-Acl File0.txt
Get-ChildItem -Path "C:\temp" -Recurse -Include "*.txt" -Force | Set-Acl -AclObject $NewAcl

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

O primeiro comando obtém o descritor de segurança do arquivo File0.txt 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 àqueles com a extensão de nome de 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, porque 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 cmdlet Set-Acl, que aplica o descritor de segurança no parâmetro AclObject a todos os arquivos no pipeline.

Na prática, é melhor usar o parâmetro WhatIf com todos os comandos Set-Acl que podem afetar mais de um item. Neste caso, o segundo comando no pipeline seria Set-Acl -AclObject $NewAcl -WhatIf. Este comando lista os arquivos que seriam afetados pelo comando. Depois de revisar o resultado, você pode executar o comando novamente sem o parâmetro WhatIf.

$NewAcl = Get-Acl -Path "C:\Pets\Dog.txt"
$isProtected = $true
$preserveInheritance = $true
$NewAcl.SetAccessRuleProtection($isProtected, $preserveInheritance)
Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

Esses comandos desabilitam a herança de acesso das pastas pai, preservando as regras de acesso herdadas existentes.

O primeiro comando usa o cmdlet Get-Acl para obter o descritor de segurança do arquivo Dog.txt.

Em seguida, as variáveis são criadas para converter as regras de acesso herdadas em regras de acesso explícitas. Para proteger as regras de acesso associadas a isso contra herança, defina a variável $isProtected como $true. Para permitir a herança, defina $isProtected como $false. Para obter mais informações, consulte definir proteção de regra de acesso.

Defina a variável $preserveInheritance como $true para preservar as regras de acesso herdadas ou $false para remover as regras de acesso herdadas. Em seguida, a proteção da regra de acesso é atualizada usando o método SetAccessRuleProtection().

O último comando usa Set-Acl para aplicar o descritor de segurança de Dog.txt. Quando o comando for concluído, as ACLs dos Dog.txt que foram herdadas da pasta Pets serão aplicadas diretamente a Dog.txte as novas políticas de acesso adicionadas a Pets não alterarão o acesso a Dog.txt.

$NewAcl = Get-Acl -Path "C:\Pets\Dog.txt"
# Set properties
$identity = "BUILTIN\Administrators"
$fileSystemRights = "FullControl"
$type = "Allow"
# Create new rule
$fileSystemAccessRuleArgumentList = $identity, $fileSystemRights, $type
$fileSystemAccessRule = New-Object -TypeName System.Security.AccessControl.FileSystemAccessRule -ArgumentList $fileSystemAccessRuleArgumentList
# Apply new rule
$NewAcl.SetAccessRule($fileSystemAccessRule)
Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

Este comando concederá ao grupo BUILTIN\Administrators controle total do arquivo Dog.txt.

O primeiro comando usa o cmdlet Get-Acl para obter o descritor de segurança do arquivo Dog.txt.

As próximas variáveis são criadas para conceder ao grupo BUILTIN\Administrators controle total do arquivo Dog.txt. A variável $identity definida como o nome de uma conta de usuário . A variável $fileSystemRights está definida como FullControl, e pode ser qualquer um dos valores de FileSystemRights que determina o tipo de operação associada à regra de acesso. A variável $type definida como "Allow" determina se a operação deve ser permitida ou recusada. A variável $fileSystemAccessRuleArgumentList é uma lista de argumentos que deve ser passada ao fazer o novo FileSystemAccessRule objeto. Em seguida, é criado um novo objeto FileSystemAccessRule, e em seguida, o objeto FileSystemAccessRule é passado para o método SetAccessRule(), adicionando a nova regra de acesso.

O último comando usa Set-Acl para aplicar o descritor de segurança de Dog.txt. Quando o comando for concluído, o grupo BUILTIN\Administrators terá controle total do Dog.txt.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Você pode canalizar um objeto ACL para este cmdlet.

Você pode canalizar um descritor de segurança para esse cmdlet.

Por padrão, esse cmdlet não retorna nenhuma saída.

Quando você usa o parâmetro PassThru, esse cmdlet retorna um objeto de segurança. O tipo do objeto de segurança depende do tipo do item.

O cmdlet Set-Acl é suportado pelos provedores PowerShell FileSystem e Registry. Como tal, você pode usá-lo para alterar os descritores de segurança de arquivos, diretórios e chaves do Registro.