AD-Berechtigungen mit PowerShell auslesen (Gruppen, OUs)

Mit PowerShell auslesen, in welchen AD-Gruppen ein Benutzer ist, wer Mitglied einer Gruppe ist und wer auf OUs welche Rechte hat. Mit CSV-Export.

„Berechtigungen im Active Directory“ meint meist eine dieser drei Fragen: Welche Gruppen hat ein Benutzer? Wer ist Mitglied einer Gruppe? Und wer darf an einer Organisationseinheit (OU) oder einem Objekt etwas ändern, zum Beispiel Kennwörter zurücksetzen? Diese Anleitung zeigt für jede Frage den passenden PowerShell-Befehl. Zum Schluss erstellst du einen Bericht über alle OUs als CSV-Datei für Excel.

Kurz gesagt:

Get-ADPrincipalGroupMembership -Identity max.mustermann | Select-Object Name
Get-ADGroupMember -Identity "Buchhaltung" -Recursive | Select-Object Name, SamAccountName
(Get-Acl -Path "AD:\OU=Vertrieb,DC=firma,DC=local").Access | Select-Object IdentityReference, ActiveDirectoryRights, AccessControlType, IsInherited

Voraussetzungen

Fehlt das Modul, installiere es in einer PowerShell mit Administratorrechten. Unter Windows 11 (Pro oder Enterprise):

Add-WindowsCapability -Online -Name Rsat.ActiveDirectory.DS-LDS.Tools~~~~0.0.1.0

Unter Windows Server:

Install-WindowsFeature -Name RSAT-AD-Tools -IncludeAllSubFeature

Lade das Modul danach in jeder neuen PowerShell-Sitzung. Es stellt auch das Laufwerk AD: bereit, das du für die Abschnitte 3 bis 5 brauchst:

Import-Module ActiveDirectory

1. In welchen Gruppen ist ein Benutzer?

Direkte Gruppenmitgliedschaften eines Benutzers (Anmeldename statt max.mustermann einsetzen):

Get-ADPrincipalGroupMembership -Identity max.mustermann | Select-Object Name, GroupScope, GroupCategory | Sort-Object Name

Der Befehl braucht laut Microsoft einen globalen Katalog in der Gesamtstruktur.

Inklusive verschachtelter Gruppen: Ist ein Benutzer über eine andere Gruppe Mitglied (Gruppe in Gruppe), zeigt dieser Befehl alle Gruppen in der Kette. Er nutzt die LDAP-Suchregel LDAP_MATCHING_RULE_IN_CHAIN:

$dn = (Get-ADUser -Identity max.mustermann).DistinguishedName
$dnFilter = $dn -replace '\\','\5c' -replace '\(','\28' -replace '\)','\29' -replace '\*','\2a'
Get-ADGroup -LDAPFilter "(member:1.2.840.113556.1.4.1941:=$dnFilter)" | Select-Object Name | Sort-Object Name

Die primäre Gruppe des Benutzers (meist „Domänen-Benutzer“) erscheint in dieser Liste nicht, weil sie nicht über das Attribut member gespeichert wird.

2. Wer ist Mitglied einer Gruppe?

Get-ADGroupMember -Identity "Buchhaltung" -Recursive | Select-Object Name, SamAccountName, objectClass | Sort-Object Name

Mit -Recursive erhältst du auch Mitglieder, die nur über verschachtelte Gruppen dazugehören. Die verschachtelten Gruppen selbst stehen dann nicht in der Liste, sondern nur die Benutzer und Computer darin. Ohne -Recursive siehst du die direkten Mitglieder, einschließlich Gruppen.

Wer Mitglied der Administratorgruppen ist, zeigt der Artikel Alle Domänenadmins mit PowerShell auslesen.

3. Wer hat welche Rechte auf eine OU oder ein Objekt?

Die Berechtigungen eines AD-Objekts liest du mit Get-Acl über das Laufwerk AD:. Gib dazu den Distinguished Name der OU, eines Benutzers oder einer Gruppe an:

$ou = "OU=Vertrieb,DC=firma,DC=local"
(Get-Acl -Path "AD:\$ou").Access | Select-Object IdentityReference, ActiveDirectoryRights, AccessControlType, IsInherited

Spalte

Bedeutung

IdentityReference

Benutzer oder Gruppe, die das Recht hat

ActiveDirectoryRights

Art des Rechts, siehe Tabelle unten

AccessControlType

Allow (erlaubt) oder Deny (verweigert)

IsInherited

True, wenn das Recht von einer übergeordneten OU geerbt ist

Häufige Werte in ActiveDirectoryRights:

Wert

Bedeutung

GenericAll

Vollzugriff

GenericRead, ReadProperty

Lesen des Objekts bzw. seiner Attribute

WriteProperty

Attribute ändern

CreateChild, DeleteChild

Unterobjekte anlegen bzw. löschen

ExtendedRight

Erweitertes Recht, zum Beispiel „Kennwort zurücksetzen“

WriteDacl

Berechtigungen ändern

WriteOwner

Besitz übernehmen

Nur ausdrücklich vergebene Rechte anzeigen: Delegierte Rechte, etwa für einen Helpdesk, erkennst du daran, dass sie nicht geerbt sind:

(Get-Acl -Path "AD:\$ou").Access | Where-Object { -not $_.IsInherited } | Select-Object IdentityReference, ActiveDirectoryRights, AccessControlType

4. GUIDs in lesbare Namen übersetzen

Viele Rechte gelten nur für ein bestimmtes Attribut, einen Objekttyp oder ein erweitertes Recht. PowerShell zeigt das in den Spalten ObjectType und InheritedObjectType nur als GUID. Mit diesem Block baust du einmal pro Sitzung eine Übersetzungstabelle aus dem Schema und den erweiterten Rechten:

$rootDse = Get-ADRootDSE
$namen = @{}
Get-ADObject -SearchBase $rootDse.SchemaNamingContext -LDAPFilter '(schemaIDGUID=*)' -Properties name, schemaIDGUID |
    ForEach-Object { $namen[[guid]$_.schemaIDGUID] = $_.name }
Get-ADObject -SearchBase "CN=Extended-Rights,$($rootDse.ConfigurationNamingContext)" -LDAPFilter '(objectClass=controlAccessRight)' -Properties name, rightsGUID |
    ForEach-Object { $namen[[guid]$_.rightsGUID] = $_.name }

Danach zeigst du die Rechte mit Namen an:

(Get-Acl -Path "AD:\$ou").Access | Select-Object IdentityReference, ActiveDirectoryRights, AccessControlType, IsInherited,
    @{ Name = 'Objekt'; Expression = { if ($_.ObjectType -eq [guid]::Empty) { 'Alle' } else { $namen[$_.ObjectType] } } },
    @{ Name = 'GiltFuer'; Expression = { $namen[$_.InheritedObjectType] } }

Steht in der Spalte Objekt zum Beispiel User-Force-Change-Password bei ExtendedRight, darf die Gruppe Kennwörter zurücksetzen. In der Spalte GiltFuer siehst du, für welche Objekte das Recht gilt, etwa user.

5. Bericht über alle OUs als CSV-Datei

Dieser Block liest die ausdrücklich vergebenen Rechte aller OUs und speichert sie auf dem Desktop. Führe vorher den Block aus Abschnitt 4 aus:

$bericht = foreach ($ou in (Get-ADOrganizationalUnit -Filter * | Select-Object -ExpandProperty DistinguishedName)) {
    (Get-Acl -Path "AD:\$ou").Access | Where-Object { -not $_.IsInherited } |
        Select-Object @{ Name = 'OU'; Expression = { $ou } }, IdentityReference, ActiveDirectoryRights, AccessControlType,
            @{ Name = 'Objekt'; Expression = { if ($_.ObjectType -eq [guid]::Empty) { 'Alle' } else { $namen[$_.ObjectType] } } },
            @{ Name = 'GiltFuer'; Expression = { $namen[$_.InheritedObjectType] } }
}
$bericht | Export-Csv -Path "$env:USERPROFILE\Desktop\OU-Berechtigungen.csv" -NoTypeInformation -Encoding UTF8 -Delimiter ';'

Mit -Delimiter ';' öffnet ein deutsches Excel die Datei direkt in Spalten. In Excel filterst du dann zum Beispiel nach einer Gruppe, um zu sehen, auf welche OUs sie Rechte hat. Den Bericht regelmäßig zu prüfen, etwa einmal im Quartal, deckt vergessene Delegierungen auf.

6. Alternativen ohne PowerShell-Skript

dsacls (Eingabeaufforderung): Das Werkzeug ist mit den AD-Verwaltungstools installiert und zeigt die Berechtigungen eines Objekts als Text, auf Wunsch direkt in eine Datei:

dsacls "OU=Vertrieb,DC=firma,DC=local"
dsacls "OU=Vertrieb,DC=firma,DC=local" > "%USERPROFILE%\Desktop\dsacls-Vertrieb.txt"

Effektive Rechte eines Benutzers (grafisch): Öffne „Active Directory-Benutzer und -Computer“, aktiviere im Menü „Ansicht“ die „Erweiterten Features“ und öffne die Eigenschaften des Objekts. Unter „Sicherheit“ → „Erweitert“ zeigt die Registerkarte „Effektiver Zugriff“ (englisch „Effective Access“), welche Rechte ein bestimmter Benutzer am Ende tatsächlich hat.

Datei- und Ordnerberechtigungen auslesen

Geht es nicht um das AD selbst, sondern um Berechtigungen auf Freigaben und Ordner, nutze ebenfalls Get-Acl, diesmal mit dem Dateipfad:

(Get-Acl -Path "\\server\freigabe\ordner").Access | Select-Object IdentityReference, FileSystemRights, AccessControlType, IsInherited

Wenn es nicht klappt

Häufige Fragen

Wie finde ich alle Domänen-Admins?

Mit Get-ADGroupMember -Identity "Domänen-Admins" -Recursive auf einem deutschen Domänencontroller (englisch „Domain Admins“). Eine ausführliche Variante für alle Admin-Gruppen steht unter Alle Domänenadmins mit PowerShell auslesen.

Brauche ich Domänen-Admin-Rechte, um Berechtigungen auszulesen?

In der Regel nicht. Gruppenmitgliedschaften und die Berechtigungen der meisten Objekte kann jedes Domänenkonto lesen. Ändern darfst du damit nichts.

Warum sehe ich GUIDs statt Namen?

Die Spalten ObjectType und InheritedObjectType enthalten GUIDs aus dem Schema bzw. aus den erweiterten Rechten. Übersetze sie mit dem Block aus Abschnitt 4.

Wie exportiere ich das Ergebnis nach Excel?

Hänge an den Befehl | Export-Csv -Path "$env:USERPROFILE\Desktop\Ergebnis.csv" -NoTypeInformation -Encoding UTF8 -Delimiter ';' an. Die Datei öffnet sich in einem deutschen Excel direkt in Spalten.

Kann ich Berechtigungen auf dieselbe Weise auch setzen?

Ja, mit Set-Acl oder dsacls. Falsch gesetzte Rechte im AD können aber Sicherheitslücken öffnen oder Dienste stören. Teste Änderungen zuerst an einer Test-OU und dokumentiere sie.

Verwandte Artikel

Unterstützung durch Dawico

Du kommst an einer Stelle nicht weiter oder möchtest Aufgaben wie diese abgeben? Die Dawico Deutschland GmbH ist seit 2008 IT-Dienstleister. Sprich uns an: telefonisch unter 030 8878680 oder über unsere Kontaktseite. Mehr zur laufenden IT-Betreuung durch Dawico.

Du bist bereits Kunde? Dann erreichst du uns über das Ticket-System oder per Fernwartung und Support.