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>]

El cmdlet Set-Acl cambia el descriptor de seguridad de un elemento especificado, como un archivo o una clave del Registro, para que coincida con los valores de un descriptor de seguridad que proporcione.

Para usar Set-Acl, utilice el parámetro de ruta de o el parámetro InputObject de para identificar el elemento cuyo descriptor de seguridad desea cambiar. A continuación, use los parámetros AclObject o SecurityDescriptor para proporcionar un descriptor de seguridad que tenga los valores que desea aplicar. Set-Acl aplica el descriptor de seguridad proporcionado. Usa el valor del parámetro AclObject como modelo y cambia los valores del descriptor de seguridad del elemento para que coincidan con los valores del parámetro AclObject.

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

Estos comandos copian los valores del descriptor de seguridad del archivo Dog.txt al descriptor de seguridad del archivo Cat.txt. Cuando se completan los comandos, los descriptores de seguridad de los archivos Dog.txt y Cat.txt son idénticos.

El primer comando usa el cmdlet Get-Acl para obtener el descriptor de seguridad del archivo Dog.txt. El operador de asignación (=) almacena el descriptor de seguridad en el valor de la variable $DogACL.

El segundo comando usa Set-Acl para cambiar los valores de la ACL de Cat.txt a los valores de $DogACL.

El valor del parámetro Path es la ruta de acceso al archivo Cat.txt. El valor del parámetro AclObject es la ACL del modelo, en este caso, la ACL de Dog.txt como se guarda en la variable $DogACL.

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

Este comando es casi el mismo que el comando del ejemplo anterior, salvo que usa un operador de canalización para enviar el descriptor de seguridad de un Get-Aclcommand a un comando Set-Acl.

El primer comando usa el cmdlet get-Acl para obtener el descriptor de seguridad del archivo Dog.txt. El operador de canalización (|) pasa un objeto que representa el descriptor de seguridad Dog.txt al cmdlet Set-Acl.

El segundo comando usa Set-Acl para aplicar el descriptor de seguridad de Dog.txt a Cat.txt. Cuando se completa el comando, las ACL de los archivos Dog.txt y Cat.txt son idénticos.

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

Estos comandos aplican los descriptores de seguridad del archivo File0.txt a todos los archivos de texto del directorio C:\Temp y todos sus subdirectorios.

El primer comando obtiene el descriptor de seguridad del archivo File0.txt en el directorio actual y usa el operador de asignación (=) para almacenarlo en la variable $NewACL.

El primer comando de la canalización usa el cmdlet Get-ChildItem para obtener todos los archivos de texto en el directorio C:\Temp. El parámetro Recurse extiende el comando a todos los subdirectorios de C:\temp. El parámetro include limita los archivos recuperados a los que tienen la extensión de nombre de archivo ".txt". El parámetro Force obtiene archivos ocultos, que de lo contrario se excluirían. (No puede usar "c:\temp*.txt", porque el parámetro Recurse funciona en directorios, no en archivos).

El operador de canalización (|) envía los objetos que representan los archivos recuperados al cmdlet Set-Acl, que aplica el descriptor de seguridad en el parámetro AclObject a todos los archivos de la canalización.

En la práctica, es mejor usar el parámetro WhatIf con todos los comandos Set-Acl que pueden afectar a más de un elemento. En este caso, el segundo comando de la canalización sería "Set-Acl -AclObject $NewAcl -WhatIf". Este comando enumera los archivos que se verían afectados por el comando. Después de revisar el resultado, puede volver a ejecutar el comando sin el parámetro WhatIf.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar un objeto ACL o un descriptor de seguridad para Set-Acl.

De forma predeterminada, Set-Acl no genera ninguna salida. Sin embargo, si usa el parámetro passthru, genera un objeto de seguridad. El tipo del objeto de seguridad depende del tipo del elemento.

El cmdlet Set-Acl es compatible con el sistema de archivos de PowerShell y los proveedores del registro. Por lo tanto, puede usarlo para cambiar los descriptores de seguridad de archivos, directorios y claves del Registro.