Get-Acl

Get-Acl
    [[-Path] <String[]>]
    [-Audit]
    [-AllCentralAccessPolicies]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-UseTransaction]
    [<CommonParameters>]

Get-Acl
    -InputObject <PSObject>
    [-Audit]
    [-AllCentralAccessPolicies]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-UseTransaction]
    [<CommonParameters>]

Get-Acl
    [-LiteralPath <String[]>]
    [-Audit]
    [-AllCentralAccessPolicies]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-UseTransaction]
    [<CommonParameters>]

L’applet de commande Get-Acl Get-Acl obtient des objets qui représentent le descripteur de sécurité d’un fichier ou d’une ressource. Le descripteur de sécurité contient les listes de contrôle d’accès (ACL) de la ressource. La liste de contrôle d’accès spécifie les autorisations que les utilisateurs et les groupes d’utilisateurs ont pour accéder à la ressource.

À compter de Windows PowerShell 3.0, vous pouvez utiliser le paramètre InputObject de Get-Acl pour obtenir le descripteur de sécurité des objets qui n’ont pas de chemin d’accès.

Get-Acl C:\Windows

Cette commande obtient le descripteur de sécurité du répertoire C :Windows.

Get-Acl C:\Windows\k*.log | Format-List -Property PSPath, Sddl

Cette commande obtient le chemin d’accès Windows PowerShell et SDDL pour tous les fichiers .log dans le répertoire C :\Windows dont les noms commencent par « k ».

La commande utilise l’applet de commande Get-A cl Get-Acl pour obtenir des objets représentant les descripteurs de sécurité de chaque fichier journal. Il utilise un opérateur de pipeline (|) pour envoyer les résultats à l’applet de commande Format-List. La commande utilise le paramètre Property de Format-List pour afficher uniquement les propriétés PsPath et SDDL de chaque objet de descripteur de sécurité.

Les listes sont souvent utilisées dans Windows PowerShell, car les valeurs longues apparaissent tronquées dans les tables.

Les valeurs SDDL sont précieuses pour les administrateurs système, car elles sont des chaînes de texte simples qui contiennent toutes les informations du descripteur de sécurité. Par conséquent, elles sont faciles à transmettre et à stocker, et peuvent être analysées si nécessaire.

Get-Acl C:/Windows/k*.log -Audit | ForEach-Object { $_.Audit.Count }

Cette commande obtient les descripteurs de sécurité des fichiers .log dans le répertoire C :\Windows dont les noms commencent par « k ». Il utilise le paramètre Audit pour obtenir les enregistrements d’audit de la liste de contrôle d’accès partagé dans le descripteur de sécurité. Ensuite, il utilise l’applet de commandeForEach-Object pour compter le nombre d’enregistrements d’audit associés à chaque fichier. Le résultat est une liste de nombres représentant le nombre d’enregistrements d’audit pour chaque fichier journal.

Get-Acl -Path HKLM:\System\CurrentControlSet\Control | Format-List

Cette commande utilise l’applet de commande Get-Acl pour obtenir le descripteur de sécurité de la sous-clé Control (HKLM\SYSTEM\CurrentControlSet\Control) du registre.

Le paramètre Path spécifie la sous-clé Control. L’opérateur de pipeline (|) transmet le descripteur de sécurité qui Get-Acl obtient à la commande Format-List, qui met en forme les propriétés du descripteur de sécurité en tant que liste afin qu’elles soient faciles à lire.

Get-Acl -InputObject (Get-StorageSubSystem -Name S087)

Cette commande utilise le paramètre InputObject de get-Acl pour obtenir le descripteur de sécurité d’un objet de sous-système de stockage.

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 une chaîne qui contient un chemin d’accès à Get-Acl.

Get-Acl retourne un objet qui représente les ACL qu’il obtient. Le type d’objet dépend du type ACL.

Par défaut, get-Acl affiche le chemin d’accès Windows PowerShell à la ressource (<fournisseur>::<chemin d’accès aux ressources>), le propriétaire de la ressource et « Access », une liste (tableau) des entrées de contrôle d’accès dans la liste de contrôle d’accès discrétionnaire (DACL) pour la ressource. La liste DACL est contrôlée par le propriétaire de la ressource.

Lorsque vous mettez en forme le résultat sous la forme d’une liste («Get-Acl | Format-List»), en plus du chemin, du propriétaire et de la liste d’accès, Windows PowerShell affiche les propriétés et les valeurs de propriété suivantes :

• groupe: groupe de sécurité du propriétaire.
• Audit: liste (tableau) d’entrées dans la liste de contrôle d’accès système (SACL). La SACL (liste de contrôle d'accès système) spécifie les types de tentatives d'accès pour lesquels Windows génère des enregistrements d'audit.
• Sddl: descripteur de sécurité de la ressource affiché dans une chaîne de texte unique au format de langage de définition du descripteur de sécurité. Windows PowerShell utilise la méthode GetSddlForm des descripteurs de sécurité pour obtenir ces données.

Étant donné que Get-Acl est pris en charge par les fournisseurs de système de fichiers et de Registre, vous pouvez utiliser get-Acl pour afficher la liste de contrôle d’accès des objets système de fichiers, tels que les fichiers et les répertoires, et les objets de Registre, tels que les clés de Registre et les entrées.