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