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