Get-ADUserGroupReport.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID fb41df9a-45ca-5d9f-9934-b149ea2b7940 .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/get-adusergroupreport.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES ActiveDirectory .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Listet die Gruppenmitgliedschaften eines oder mehrerer AD-Benutzer auf, auf Wunsch inklusive verschachtelter Gruppen. .DESCRIPTION Nimmt Benutzernamen direkt, über die Pipeline oder aus einer Textdatei (ein Name pro Zeile) entgegen und gibt für jeden Benutzer seine Gruppen als Objekte aus. Die Ausgabe lässt sich weiterverarbeiten, etwa mit Export-Csv oder Out-GridView. Mit -Recursive werden auch Gruppen ermittelt, in denen der Benutzer nur indirekt Mitglied ist. .PARAMETER Identity Ein oder mehrere Benutzer (SamAccountName, UPN oder Distinguished Name). .PARAMETER Path Textdatei mit einem Benutzernamen pro Zeile. .PARAMETER Recursive Auch verschachtelte Gruppenmitgliedschaften auflösen. .EXAMPLE .\Get-ADUserGroupReport.ps1 -Identity max.mustermann .EXAMPLE .\Get-ADUserGroupReport.ps1 -Path .\benutzer.txt -Recursive | Export-Csv .\gruppen.csv -NoTypeInformation -Encoding UTF8 .EXAMPLE Get-ADUser -Filter 'Department -eq "Vertrieb"' | .\Get-ADUserGroupReport.ps1 | Out-GridView .NOTES Autor: Torsten Weise, powerscripting.de #> [CmdletBinding(DefaultParameterSetName = 'Identity')] param( [Parameter(Mandatory, ParameterSetName = 'Identity', ValueFromPipeline, ValueFromPipelineByPropertyName, Position = 0)] [Alias('SamAccountName')] [string[]] $Identity, [Parameter(Mandatory, ParameterSetName = 'File')] [ValidateScript({ Test-Path $_ -PathType Leaf })] [string] $Path, [switch] $Recursive ) Import-Module ActiveDirectory -ErrorAction Stop begin { if ($PSCmdlet.ParameterSetName -eq 'File') { $Identity = Get-Content -Path $Path | Where-Object { $_.Trim() } | ForEach-Object { $_.Trim() } } } process { foreach ($id in $Identity) { try { $user = Get-ADUser -Identity $id -Properties MemberOf, PrimaryGroup -ErrorAction Stop } catch { Write-Warning "Benutzer nicht gefunden: $id" continue } if ($Recursive) { # LDAP_MATCHING_RULE_IN_CHAIN löst die komplette Verschachtelung serverseitig auf $groups = Get-ADGroup -LDAPFilter "(member:1.2.840.113556.1.4.1941:=$($user.DistinguishedName))" } else { $groups = $user.MemberOf | ForEach-Object { Get-ADGroup -Identity $_ } } $groups = @($groups) + (Get-ADGroup -Identity $user.PrimaryGroup) $groups | Sort-Object Name -Unique | ForEach-Object { [pscustomobject]@{ Benutzer = $user.SamAccountName Gruppe = $_.Name Typ = $_.GroupCategory Bereich = $_.GroupScope Direkt = $user.MemberOf -contains $_.DistinguishedName -or $_.DistinguishedName -eq $user.PrimaryGroup } } } } |