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"