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