Get-LocalAdminReport.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID bd8701e8-db75-5b38-8eb3-5c4bfe786fa3
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Security Hardening Windows Audit PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/get-localadminreport.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 Mitglieder der lokalen Administratorengruppe auf vielen Rechnern und markiert alles, was dort nicht hingehört.
 
.DESCRIPTION
    Liest per PowerShell-Remoting auf jedem Rechner die Gruppe der lokalen Administratoren aus. Die Gruppe
    wird über ihre feste SID S-1-5-32-544 gefunden, das Skript funktioniert also auch auf deutschen
    ("Administratoren") und englischen Systemen. Die Abfrage läuft über ADSI, weil Get-LocalGroupMember
    bei verwaisten SIDs abbricht.
 
    Jedes Mitglied wird mit der Liste -Allowed verglichen. Was nicht auf der Liste steht, erscheint als
    "Prüfen". Typische Funde: Benutzer, die einmal für eine Softwareinstallation Adminrechte bekommen
    haben, alte Dienstkonten und verwaiste SIDs gelöschter Konten.
 
    Ohne -ComputerName werden alle aktivierten Computer aus dem Active Directory abgefragt, die sich in
    den letzten 30 Tagen angemeldet haben.
 
.PARAMETER ComputerName
    Zu prüfende Rechner. Ohne Angabe: aktive Computer aus dem AD.
 
.PARAMETER SearchBase
    Optional. OU, auf die sich die AD-Abfrage beschränkt.
 
.PARAMETER Allowed
    Mitglieder, die erwartet werden. Platzhalter sind erlaubt. Standard: das eingebaute Konto
    Administrator, Domänen-Admins und eine Gruppe "LAPS"/"Workstation Admins", falls vorhanden.
 
.PARAMETER ReportPath
    Ordner für HTML- und CSV-Bericht. Standard: aktueller Ordner.
 
.PARAMETER SmtpServer
    Optional. Mailserver für den Versand des Berichts.
 
.PARAMETER From
    Absender des Berichts.
 
.PARAMETER To
    Empfänger des Berichts.
 
.EXAMPLE
    .\Get-LocalAdminReport.ps1 -SearchBase "OU=Clients,DC=contoso,DC=local"
 
    Prüft alle aktiven Clients einer OU mit der Standardliste.
 
.EXAMPLE
    .\Get-LocalAdminReport.ps1 -ComputerName FS01, APP01 -Allowed '*\Administrator', '*\Domänen-Admins', 'CONTOSO\GG-Server-Admins'
 
    Prüft zwei Server mit eigener Liste erlaubter Mitglieder.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Das Skript ändert nichts. Wer lokale Adminrechte dauerhaft im Griff haben will, verteilt die
    Gruppe per Gruppenrichtlinie (Eingeschränkte Gruppen oder Lokale Benutzer und Gruppen) und
    nutzt Windows LAPS für das Kennwort des eingebauten Administrators.
#>

[CmdletBinding()]
param(
    [string[]] $ComputerName,
    [string] $SearchBase,
    [string[]] $Allowed = @('*\Administrator', '*\Domain Admins', '*\Domänen-Admins', '*\Workstation Admins', '*\LAPS*'),
    [string] $ReportPath = (Get-Location).Path,
    [string] $SmtpServer,
    [string] $From,
    [string[]] $To
)

if (-not $ComputerName) {
    Import-Module ActiveDirectory -ErrorAction Stop
    $params = @{ Filter = 'Enabled -eq $true'; Properties = 'LastLogonDate' }
    if ($SearchBase) { $params.SearchBase = $SearchBase }
    $ComputerName = Get-ADComputer @params |
        Where-Object { $_.LastLogonDate -gt (Get-Date).AddDays(-30) } |
        Select-Object -ExpandProperty DNSHostName | Sort-Object
    Write-Host "$($ComputerName.Count) aktive Computer aus dem AD"
}

$query = {
    $sid   = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-544')
    $name  = $sid.Translate([Security.Principal.NTAccount]).Value.Split('\')[-1]
    $group = [ADSI]"WinNT://$env:COMPUTERNAME/$name,group"
    foreach ($m in @($group.psbase.Invoke('Members'))) {
        $path  = $m.GetType().InvokeMember('ADsPath', 'GetProperty', $null, $m, $null)
        $class = $m.GetType().InvokeMember('Class', 'GetProperty', $null, $m, $null)
        # WinNT://DOMAIN/Name oder WinNT://DOMAIN/COMPUTER/Name; verwaiste SIDs erscheinen als WinNT://S-1-5-...
        $parts = $path -replace '^WinNT://', '' -split '/'
        $account = if ($parts.Count -ge 3) { "$($parts[1])\$($parts[2])" }
                   elseif ($parts.Count -eq 2) { "$($parts[0])\$($parts[1])" }
                   else { $parts[0] }
        [pscustomobject]@{ Mitglied = $account; Typ = $class; Verwaist = ($account -match '^S-1-') }
    }
}

$rows = [System.Collections.Generic.List[object]]::new()
$i = 0
foreach ($computer in $ComputerName) {
    $i++
    Write-Progress -Activity 'Lokale Administratoren' -Status $computer -PercentComplete (100 * $i / $ComputerName.Count)
    try {
        $members = if ($computer -in 'localhost', '.', $env:COMPUTERNAME) { & $query }
                   else { Invoke-Command -ComputerName $computer -ScriptBlock $query -ErrorAction Stop }
        foreach ($m in $members) {
            $ok = $false
            foreach ($pattern in $Allowed) { if ($m.Mitglied -like $pattern) { $ok = $true; break } }
            $rows.Add([pscustomobject]@{
                Computer  = $computer
                Mitglied  = $m.Mitglied
                Typ       = $m.Typ
                Bewertung = if ($m.Verwaist) { 'Verwaist' } elseif ($ok) { 'Erwartet' } else { 'Prüfen' }
            })
        }
    }
    catch {
        $rows.Add([pscustomobject]@{ Computer = $computer; Mitglied = $_.Exception.Message; Typ = ''; Bewertung = 'Nicht erreichbar' })
    }
}
Write-Progress -Activity 'Lokale Administratoren' -Completed

$check = @($rows | Where-Object { $_.Bewertung -in 'Prüfen', 'Verwaist' })
$check | Sort-Object Computer, Mitglied | Format-Table -AutoSize

Write-Host ("{0} Rechner, {1} Einträge zum Prüfen, {2} nicht erreichbar" -f $ComputerName.Count, $check.Count,
    @($rows | Where-Object Bewertung -eq 'Nicht erreichbar').Count)

# Häufigste unerwartete Mitglieder zuerst, das zeigt Muster (z. B. eine Gruppe auf 200 Clients)
$top = $check | Group-Object Mitglied | Sort-Object Count -Descending |
    Select-Object @{ n = 'Mitglied'; e = { $_.Name } }, @{ n = 'Anzahl Rechner'; e = { $_.Count } }

$now   = Get-Date
$title = "Lokale Administratoren - $($now.ToString('dd.MM.yyyy'))"
$css   = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse;margin-bottom:20px}td,th{border:1px solid #ccc;padding:4px 8px}th{background:#eee}</style>'
$html  = ConvertTo-Html -Title $title -Head $css -PreContent "<h2>$title</h2><p>$($ComputerName.Count) Rechner, $($check.Count) Einträge zum Prüfen.</p>" -Body (
    ($top | ConvertTo-Html -Fragment -PreContent '<h3>Unerwartete Mitglieder nach Häufigkeit</h3>' | Out-String) +
    ($check | Sort-Object Computer, Mitglied | ConvertTo-Html -Fragment -PreContent '<h3>Alle Funde</h3>' | Out-String)) | Out-String
$base = Join-Path $ReportPath ("LokaleAdmins_{0:yyyy-MM-dd}" -f $now)
$html | Set-Content -Path "$base.html" -Encoding UTF8
$rows | Export-Csv -Path "$base.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8
Write-Host "Bericht: $base.html und $base.csv"

if ($SmtpServer -and $From -and $To) {
    Send-MailMessage -SmtpServer $SmtpServer -From $From -To $To -Subject $title -Body $html -BodyAsHtml -Encoding UTF8
}