#Powerscripting

Skripte / find-folderpermission

Ordnerrechte eines Benutzers finden

Zeigt, auf welche Ordner einer Struktur ein Benutzer Zugriff hat, direkt oder über (verschachtelte) Gruppen.

#ActiveDirectoryPowerShellFind-FolderPermission

Auf einen Blick

  • Voraussetzung – ActiveDirectory-Modul (RSAT)
  • PowerShell – Windows PowerShell 5.1 oder PowerShell 7
  • Testlauf – liest nur, ändert nichts
  • Installieren – Install-Script Find-FolderPermission aus der PowerShell Gallery, Version 1.0.0

01

Was das Skript macht

Durchsucht einen Ordner samt Unterordnern und prüft die Berechtigungen (ACL) jedes Ordners. Ein Treffer liegt vor, wenn ein Eintrag für den Benutzer selbst oder für eine seiner Gruppen existiert. Verschachtelte Gruppen werden aufgelöst, und der Vergleich erfolgt über die SID, nicht über den Namen. Dadurch gibt es keine Fehltreffer bei ähnlichen Namen.

Die Ausgabe sind Objekte mit Ordner, Berechtigung, Art (Zulassen/Verweigern) und dem Konto, über das der Zugriff besteht.

02

Parameter

ParameterAngabeBedeutung
-PathPflichtStammordner der Suche, lokal oder als UNC-Pfad.
-IdentityPflichtBenutzer, dessen Zugriffe gesucht werden.
-DepthoptionalOptional. Maximale Suchtiefe unterhalb von -Path.
-IncludeInheritedoptionalAuch geerbte Berechtigungen ausgeben. Standard: nur explizit gesetzte, damit die Liste übersichtlich bleibt.

03

Beispiele

Beispiel 1
.\Find-FolderPermission.ps1 -Path \\fs01\daten -Identity max.mustermann
Beispiel 2
.\Find-FolderPermission.ps1 -Path D:\Daten -Identity max.mustermann -Depth 3 | Export-Csv .\rechte.csv -NoTypeInformation -Encoding UTF8

04

Quellcode

Die Datei ist als UTF-8 mit BOM gespeichert, damit Umlaute auch in Windows PowerShell 5.1 korrekt ankommen. Heruntergeladene Skripte blockiert Windows unter Umständen. Freigeben mit Unblock-File .\Find-FolderPermission.ps1.

Find-FolderPermission.ps1
<#PSScriptInfo
.VERSION 1.0.0
.GUID c2992be6-9a6c-5e12-8826-0ed16dfbe370
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German ActiveDirectory AD Windows Fileserver PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/find-folderpermission.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES ActiveDirectory
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>

<#
.SYNOPSIS
    Zeigt, auf welche Ordner einer Struktur ein Benutzer Zugriff hat, direkt oder über (verschachtelte) Gruppen.

.DESCRIPTION
    Durchsucht einen Ordner samt Unterordnern und prüft die Berechtigungen (ACL) jedes Ordners. Ein Treffer liegt
    vor, wenn ein Eintrag für den Benutzer selbst oder für eine seiner Gruppen existiert. Verschachtelte Gruppen
    werden aufgelöst, und der Vergleich erfolgt über die SID, nicht über den Namen. Dadurch gibt es keine
    Fehltreffer bei ähnlichen Namen.

    Die Ausgabe sind Objekte mit Ordner, Berechtigung, Art (Zulassen/Verweigern) und dem Konto, über das der
    Zugriff besteht.

.PARAMETER Path
    Stammordner der Suche, lokal oder als UNC-Pfad.

.PARAMETER Identity
    Benutzer, dessen Zugriffe gesucht werden.

.PARAMETER Depth
    Optional. Maximale Suchtiefe unterhalb von -Path.

.PARAMETER IncludeInherited
    Auch geerbte Berechtigungen ausgeben. Standard: nur explizit gesetzte, damit die Liste übersichtlich bleibt.

.EXAMPLE
    .\Find-FolderPermission.ps1 -Path \\fs01\daten -Identity max.mustermann

.EXAMPLE
    .\Find-FolderPermission.ps1 -Path D:\Daten -Identity max.mustermann -Depth 3 | Export-Csv .\rechte.csv -NoTypeInformation -Encoding UTF8

.NOTES
    Autor:   Torsten Weise, powerscripting.de
    Ordner, die das ausführende Konto nicht lesen darf, werden als Warnung gemeldet und übersprungen.
#>
[CmdletBinding()]
param(
    [Parameter(Mandatory, Position = 0)] [ValidateScript({ Test-Path $_ -PathType Container })] [string] $Path,
    [Parameter(Mandatory, Position = 1)] [string] $Identity,
    [int] $Depth,
    [switch] $IncludeInherited
)

Import-Module ActiveDirectory -ErrorAction Stop

$user   = Get-ADUser -Identity $Identity
$groups = Get-ADGroup -LDAPFilter "(member:1.2.840.113556.1.4.1941:=$($user.DistinguishedName))"

# SID -> Anzeigename für Benutzer und alle Gruppen
$sids = @{ $user.SID.Value = $user.SamAccountName }
foreach ($g in $groups) { $sids[$g.SID.Value] = $g.Name }

$folders = @(Get-Item -LiteralPath $Path)
$params  = @{ LiteralPath = $Path; Directory = $true; Recurse = $true; ErrorAction = 'SilentlyContinue'; ErrorVariable = 'denied' }
if ($PSBoundParameters.ContainsKey('Depth')) { $params.Depth = $Depth }
$folders += Get-ChildItem @params
foreach ($err in $denied) { Write-Warning "Kein Zugriff: $($err.TargetObject)" }

foreach ($folder in $folders) {
    try {
        $acl = Get-Acl -LiteralPath $folder.FullName -ErrorAction Stop
    }
    catch {
        Write-Warning "ACL nicht lesbar: $($folder.FullName)"
        continue
    }
    foreach ($ace in $acl.GetAccessRules($true, $IncludeInherited.IsPresent, [System.Security.Principal.SecurityIdentifier])) {
        $sid = $ace.IdentityReference.Value
        if ($sids.ContainsKey($sid)) {
            [pscustomobject]@{
                Ordner       = $folder.FullName
                Recht        = $ace.FileSystemRights
                Art          = if ($ace.AccessControlType -eq 'Allow') { 'Zulassen' } else { 'Verweigern' }
                'Über'       = $sids[$sid]
                Geerbt       = $ace.IsInherited
            }
        }
    }
}

Weitere Skripte