Set-Acl

  • Referência
Módulo:
Microsoft.PowerShell.Security

Altera o descritor de segurança de um item especificado, como um arquivo ou uma chave do Registro.

Sintaxe

Set-Acl
   [-Path] <String[]>
   [-AclObject] <Object>
   [-ClearCentralAccessPolicy]
   [-Passthru]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Acl
   [-InputObject] <PSObject>
   [-AclObject] <Object>
   [-Passthru]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Acl
   -LiteralPath <String[]>
   [-AclObject] <Object>
   [-ClearCentralAccessPolicy]
   [-Passthru]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet só está disponível na plataforma Windows.

O Set-Acl cmdlet 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-Aclo , use o parâmetro Path ou InputObject para identificar o item cujo descritor de segurança você deseja alterar. Em seguida, use os parâmetros AclObject ou SecurityDescriptor para fornecer um descritor de segurança que tenha os valores que você deseja 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 .

Exemplos

Exemplo 1: Copiar um descritor de segurança de um ficheiro para outro

$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 Get-Acl cmdlet 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 $DogACL variável.

Exemplo 2: Usar o operador de pipeline para passar um descritor

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

Esse 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 Get-Acl comando para um Set-Acl comando.

O primeiro comando usa o Get-Acl cmdlet 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 Set-Acl cmdlet.

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.

Exemplo 3: Aplicar um descritor de segurança a vários ficheiros

$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 e todos os C:\Temp 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 $NewACL variável.

O primeiro comando no pipeline usa o cmdlet Get-ChildItem para obter todos os arquivos de texto no C:\Temp diretório. O parâmetro Recurse estende o comando a todos os subdiretórios do C:\temp. O parâmetro Include limita os arquivos recuperados àqueles com a extensão de nome de .txt arquivo. O parâmetro Force obtém arquivos ocultos, que de outra forma seriam excluídos. (Não é possível usar c:\temp\*.txto , 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 Set-Acl cmdlet, 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 Set-Acl comandos 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 .

Exemplo 4: Desativar a herança e preservar as regras de acesso herdadas

$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 Get-Acl cmdlet 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 $isProtected variável 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 $preserveInheritance variável 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 é usado 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 ao Dog.txt e as novas políticas de acesso adicionadas ao Pets não alterarão o acesso a Dog.txt.

Exemplo 5: Conceder aos administradores o controle total do arquivo

$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\Administradores controle total do arquivo Dog.txt.

O primeiro comando usa o Get-Acl cmdlet 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 $identity variável definida como o nome de uma conta de usuário. A $fileSystemRights variável definida como FullControl e pode ser qualquer um dos valores FileSystemRights que especifica o tipo de operação associada à regra de acesso. A $type variável definida como "Allow" especifica se a operação deve ser permitida ou negada. A $fileSystemAccessRuleArgumentList variável é uma lista de argumentos que deve ser passada ao criar o novo objeto FileSystemAccessRule . Em seguida, um novo objeto FileSystemAccessRule é criado e o objeto FileSystemAccessRule é passado para o método SetAccessRule(), adiciona a nova regra de acesso.

O último comando é usado 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.

Parâmetros

-AclObject

Especifica uma ACL com os valores de propriedade desejados. Set-Acl altera a ACL do item especificado pelo parâmetro Path ou InputObject para corresponder aos valores no objeto de segurança especificado.

Você pode salvar a saída de um Get-Acl comando em uma variável e, em seguida, usar o parâmetro AclObject para passar a variável ou digitar um Get-Acl comando.

Tipo:Object
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ClearCentralAccessPolicy

Remove a política de acesso central do item especificado.

A partir do Windows Server 2012, os administradores podem usar o Ative Directory e a Diretiva de Grupo para definir políticas de acesso central para usuários e grupos. Para obter mais informações, consulte Controle de acesso dinâmico: visão geral do cenário.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Exclude

Omite os itens especificados. O valor desse parâmetro qualifica o parâmetro Path . Insira um elemento ou padrão de caminho, como *.txt. Curingas são permitidos.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Filter

Especifica um filtro no formato ou idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path . A sintaxe do filtro, incluindo o uso de curingas, depende do provedor. Os filtros são mais eficientes do que outros parâmetros, porque o provedor os aplica ao recuperar os objetos, em vez de fazer com que o PowerShell filtre os objetos depois que eles são recuperados.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Include

Altera apenas os itens especificados. O valor desse parâmetro qualifica o parâmetro Path . Insira um elemento ou padrão de caminho, como *.txt. Curingas são permitidos.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-InputObject

Altera o descritor de segurança do objeto especificado. Insira uma variável que contenha o objeto ou um comando que obtenha o objeto.

Não é possível canalizar o objeto a ser alterado para Set-Acl. Em vez disso, use o parâmetro InputObject explicitamente no comando.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Tipo:PSObject
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LiteralPath

Altera o descritor de segurança do item especificado. Ao contrário de Path, o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples ('). Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Tipo:String[]
Aliases:PSPath
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Passthru

Retorna um objeto que representa o descritor de segurança que foi alterado. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Altera o descritor de segurança do item especificado. Insira o caminho para um item, como um caminho para um arquivo ou chave do Registro. Curingas são permitidos.

Se você passar um objeto de segurança para Set-Acl (usando os parâmetros AclObject ou SecurityDescriptor ou passando um objeto de segurança de Get-Acl para Set-Acl) e omitir o parâmetro Path (nome e valor), Set-Acl usará o caminho incluído no objeto de segurança.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

ObjectSecurity

Você pode canalizar um objeto ACL para este cmdlet.

CommonSecurityDescriptor

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

Saídas

None

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

FileSecurity

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.

Notas

Este cmdlet só está disponível em plataformas Windows.

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