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