Find-StaleComputerAccount.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID 5747f37e-eb5e-5060-bef2-33e63da143f1 .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/find-stalecomputeraccount.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES ActiveDirectory .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Findet Computerkonten im AD, die sich lange nicht angemeldet haben, und deaktiviert oder verschiebt sie auf Wunsch. .DESCRIPTION Ein Computerkonto ändert sein Kennwort normalerweise alle 30 Tage selbst. Bleiben letzte Anmeldung und letzter Kennwortwechsel beide länger als -DaysInactive Tage aus, ist der Rechner fast immer ausgemustert, neu installiert oder dauerhaft offline. Solche Konten sind Altlasten: Sie verfälschen Lizenz- und Inventurzahlen und können von Angreifern übernommen werden. Ohne weitere Schalter erstellt das Skript nur einen Bericht. Mit -Disable werden die Konten deaktiviert und in der Beschreibung mit Datum markiert, mit -TargetOU zusätzlich verschoben. Gelöscht wird nichts: Das bleibt eine bewusste Entscheidung nach einer Wartezeit. Domänencontroller und Cluster-Objekte (CNO/VCO) werden übersprungen. .PARAMETER SearchBase Optional. OU, in der gesucht wird. Standard: ganze Domäne. .PARAMETER DaysInactive Anzahl Tage ohne Anmeldung und ohne Kennwortwechsel. Standard: 90. .PARAMETER Disable Gefundene Konten deaktivieren. .PARAMETER TargetOU Optional. OU, in die deaktivierte Konten verschoben werden. .PARAMETER ReportPath Ordner für den CSV-Bericht. Standard: aktueller Ordner. .EXAMPLE .\Find-StaleComputerAccount.ps1 Listet alle Computerkonten, die 90 Tage nicht aktiv waren. Ändert nichts. .EXAMPLE .\Find-StaleComputerAccount.ps1 -DaysInactive 120 -Disable -TargetOU "OU=Deaktiviert,DC=contoso,DC=local" -WhatIf Zeigt, welche Konten deaktiviert und verschoben würden. .NOTES Autor: Torsten Weise, powerscripting.de LastLogonDate basiert auf lastLogonTimestamp und wird nur alle 9 bis 14 Tage repliziert. Schwellen unter 30 Tagen sind daher nicht sinnvoll. Rechner, die lange im Lager liegen oder nur per VPN kommen, vorher mit einer eigenen OU oder Beschreibung ausnehmen. #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')] param( [string] $SearchBase, [ValidateRange(30, 3650)] [int] $DaysInactive = 90, [switch] $Disable, [string] $TargetOU, [string] $ReportPath = (Get-Location).Path ) Import-Module ActiveDirectory -ErrorAction Stop $now = Get-Date $cutoff = $now.AddDays(-$DaysInactive) $stamp = $now.ToString('dd.MM.yyyy') $params = @{ Filter = 'Enabled -eq $true' Properties = 'LastLogonDate', 'PasswordLastSet', 'whenCreated', 'OperatingSystem', 'Description', 'servicePrincipalName', 'userAccountControl' } if ($SearchBase) { $params.SearchBase = $SearchBase } $stale = Get-ADComputer @params | Where-Object { # 8192 = SERVER_TRUST_ACCOUNT (Domänencontroller) -not ($_.userAccountControl -band 8192) -and -not ($_.servicePrincipalName -match '^MSClusterVirtualServer/') -and $_.whenCreated -lt $cutoff -and (-not $_.LastLogonDate -or $_.LastLogonDate -lt $cutoff) -and (-not $_.PasswordLastSet -or $_.PasswordLastSet -lt $cutoff) } $rows = foreach ($c in $stale) { $last = @($c.LastLogonDate, $c.PasswordLastSet) | Where-Object { $_ } | Sort-Object -Descending | Select-Object -First 1 [pscustomobject]@{ Computer = $c.Name Betriebssystem = $c.OperatingSystem 'Letzte Anmeldung' = if ($c.LastLogonDate) { $c.LastLogonDate.ToString('dd.MM.yyyy') } else { 'nie' } 'Kennwort gesetzt' = if ($c.PasswordLastSet) { $c.PasswordLastSet.ToString('dd.MM.yyyy') } else { '' } 'Tage inaktiv' = if ($last) { [int]($now - $last).TotalDays } else { [int]($now - $c.whenCreated).TotalDays } OU = ($c.DistinguishedName -split ',', 2)[1] Beschreibung = $c.Description DN = $c.DistinguishedName } } $rows = @($rows | Sort-Object 'Tage inaktiv' -Descending) if ($rows.Count -eq 0) { Write-Host "Keine Computerkonten über $DaysInactive Tage inaktiv." -ForegroundColor Green return } $rows | Format-Table Computer, Betriebssystem, 'Letzte Anmeldung', 'Tage inaktiv', OU -AutoSize Write-Host "$($rows.Count) Computerkonten über $DaysInactive Tage inaktiv." if ($Disable) { foreach ($r in $rows) { if ($PSCmdlet.ShouldProcess($r.Computer, 'Deaktivieren' + $(if ($TargetOU) { " und nach $TargetOU verschieben" }))) { Set-ADComputer -Identity $r.DN -Enabled $false -Description "[Inaktiv seit $($r.'Letzte Anmeldung') - deaktiviert $stamp] $($r.Beschreibung)" if ($TargetOU) { Move-ADObject -Identity $r.DN -TargetPath $TargetOU } } } } $file = Join-Path $ReportPath ("InaktiveComputer_{0:yyyy-MM-dd}.csv" -f $now) $rows | Select-Object -Property * -ExcludeProperty DN | Export-Csv -Path $file -NoTypeInformation -Delimiter ';' -Encoding UTF8 Write-Host "Bericht: $file" |