Set-Acl

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
    [-AclObject] <Object>
    -LiteralPath <String[]>
    [-ClearCentralAccessPolicy]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet de commande Set-Acl modifie le descripteur de sécurité d’un élément spécifié, tel qu’un fichier ou une clé de Registre, pour qu’il corresponde aux valeurs d’un descripteur de sécurité que vous fournissez.

Pour utiliser , utilisez le chemin d’accès ou paramètre InputObject pour identifier l’élément dont vous souhaitez modifier le descripteur de sécurité. Utilisez ensuite les paramètres de AclObject ou SecurityDescriptor pour fournir un descripteur de sécurité qui a les valeurs que vous souhaitez appliquer. Set-Acl applique le descripteur de sécurité fourni. Il utilise la valeur du paramètre AclObject en tant que modèle et modifie les valeurs du descripteur de sécurité de l’élément pour qu’elles correspondent aux valeurs du paramètre AclObject.

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

Ces commandes copient les valeurs du descripteur de sécurité du fichier Dog.txt vers le descripteur de sécurité du fichier Cat.txt. Une fois les commandes terminées, les descripteurs de sécurité des fichiers Dog.txt et Cat.txt sont identiques.

La première commande utilise l’applet de commande Get-Acl pour obtenir le descripteur de sécurité du fichier Dog.txt. L’opérateur d’affectation (=) stocke le descripteur de sécurité dans la valeur de la variable $DogACL.

La seconde commande utilise Set-Acl pour changer les valeurs dans l'ACL de Cat.txt en celles de $DogACL.

La valeur du paramètre Path est le chemin d’accès au fichier Cat.txt. La valeur du paramètre AclObject est la liste de contrôle d’accès du modèle, dans ce cas, la liste de contrôle d’accès de Dog.txt enregistrée dans la variable $DogACL.

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

Cette commande est presque identique à la commande de l’exemple précédent, sauf qu’elle utilise un opérateur de pipeline (|) pour envoyer le descripteur de sécurité d’une commande Get-Acl à une commande Set-Acl.

La première commande utilise l’applet de commande Get-Acl pour obtenir le descripteur de sécurité du fichier Dog.txt. L’opérateur de pipeline (|) transmet un objet qui représente le descripteur de sécurité Dog.txt à l’applet de commande Set-Acl.

La deuxième commande utilise Set-Acl pour appliquer le descripteur de sécurité de Dog.txt à Cat.txt. Une fois la commande terminée, les listes de contrôle d’accès des fichiers Dog.txt et Cat.txt sont identiques.

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

Ces commandes appliquent les descripteurs de sécurité dans le fichier File0.txt à tous les fichiers texte du répertoire C:\Temp et à tous ses sous-répertoires.

La première commande obtient le descripteur de sécurité du fichier File0.txt dans le répertoire actif et utilise l’opérateur d’affectation (=) pour le stocker dans la variable $NewACL.

La première commande du pipeline utilise l’applet de commande Get-ChildItem pour obtenir tous les fichiers texte dans le répertoire C:\Temp. Le paramètre Recurse étend la commande à tous les sous-répertoires de C:\temp. Le paramètre Include limite les fichiers récupérés à ceux avec l’extension du nom de fichier .txt. Le paramètre Force récupère les fichiers masqués, qui seraient autrement exclus. (Vous ne pouvez pas utiliser C:\temp\*.txt, car le paramètre recurse fonctionne sur les répertoires, et non sur les fichiers.)

L’opérateur de pipeline (|) envoie les objets représentant les fichiers récupérés à l’applet de commande Set-Acl, qui applique le descripteur de sécurité dans le paramètre AclObject à tous les fichiers du pipeline.

Dans la pratique, il est préférable d’utiliser le paramètre WhatIf avec toutes les commandes Set-Acl qui peuvent affecter plusieurs éléments. Dans ce cas, la deuxième commande du pipeline serait Set-Acl -AclObject $NewAcl -WhatIf. Cette commande répertorie les fichiers qui seraient affectés par la commande. Après avoir examiné le résultat, vous pouvez réexécuter la commande sans le paramètre 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

Ces commandes désactivent l’héritage d’accès à partir de dossiers parents, tout en conservant les règles d’accès héritées existantes.

La première commande utilise l’applet de commande Get-Acl pour obtenir le descripteur de sécurité du fichier Dog.txt.

Ensuite, les variables sont créées pour convertir les règles d’accès héritées en règles d’accès explicites. Pour protéger les règles d'accès associées à ceci contre l'héritage, définissez la variable $isProtected sur $true. Pour autoriser l’héritage, définissez $isProtected sur $false. Pour plus d'informations, reportez-vous à la section Définir la protection des règles d'accès.

Définissez la variable $preserveInheritance sur $true pour conserver les règles d’accès héritées ou $false pour supprimer les règles d’accès héritées. Ensuite, la protection des règles d’accès est mise à jour à l’aide de la méthode SetAccessRuleProtection().

La dernière commande utilise Set-Acl pour appliquer le descripteur de sécurité de Dog.txt. Une fois la commande terminée, les listes de contrôle d’accès des Dog.txt héritées du dossier Animaux de compagnie sont appliquées directement à Dog.txt, et les nouvelles stratégies d’accès ajoutées aux animaux de compagnie ne modifient pas l’accès à 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
$newParams = @{
  TypeName     = 'System.Security.AccessControl.FileSystemAccessRule'
    ArgumentList = $fileSystemAccessRuleArgumentList
}
$fileSystemAccessRule = New-Object @newParams
# Apply new rule
$NewAcl.SetAccessRule($fileSystemAccessRule)
Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

Cette commande accorde au groupe BUILTIN\Administrators le contrôle total du fichier Dog.txt.

La première commande utilise l’applet de commande Get-Acl pour obtenir le descripteur de sécurité du fichier Dog.txt.

Les variables suivantes sont créées pour accorder au BUILTIN\Administrators groupe le contrôle total du fichier Dog.txt. La variable $identity correspond au nom d'un compte d'utilisateur. La variable $fileSystemRights définie sur FullControl et peut être l’une des valeurs FileSystemRights qui spécifie le type d’opération associé à la règle d’accès. La variable $type définie sur « Autoriser » pour spécifier s’il faut autoriser ou refuser l’opération. La variable $fileSystemAccessRuleArgumentList est une liste d’arguments à passer lors de la création du nouvel objet FileSystemAccessRule. Ensuite, un nouvel objet FileSystemAccessRule est créé, et l’objet FileSystemAccessRule est passé à la méthode SetAccessRule(), ajoute la nouvelle règle d’accès.

La dernière commande utilise Set-Acl pour appliquer le descripteur de sécurité de Dog.txt. Une fois la commande terminée, le groupe BUILTIN\Administrators aura le contrôle total de l'Dog.txt.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger un objet ACL vers cette applet de commande.

Vous pouvez diriger un descripteur de sécurité vers cette applet de commande.

Par défaut, cette applet de commande ne retourne aucune sortie.

Lorsque vous utilisez le paramètre passThru, cette applet de commande retourne un objet de sécurité. Le type de l’objet de sécurité dépend du type de l’élément.

Cette applet de commande est disponible uniquement sur les plateformes Windows.

L’applet de commande Set-Acl est prise en charge par les fournisseurs PowerShell FileSystem et Registry. Par conséquent, vous pouvez l’utiliser pour modifier les descripteurs de sécurité des fichiers, des répertoires et des clés de Registre.