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
| Parameter | Angabe | Bedeutung |
|---|---|---|
-Path | Pflicht | Stammordner der Suche, lokal oder als UNC-Pfad. |
-Identity | Pflicht | Benutzer, dessen Zugriffe gesucht werden. |
-Depth | optional | Optional. Maximale Suchtiefe unterhalb von -Path. |
-IncludeInherited | optional | Auch geerbte Berechtigungen ausgeben. Standard: nur explizit gesetzte, damit die Liste übersichtlich bleibt. |
03
Beispiele
.\Find-FolderPermission.ps1 -Path \\fs01\daten -Identity max.mustermann.\Find-FolderPermission.ps1 -Path D:\Daten -Identity max.mustermann -Depth 3 | Export-Csv .\rechte.csv -NoTypeInformation -Encoding UTF804
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.
<#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
}
}
}
}War das hilfreich?