Disable-InactiveADUser.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID db32bc0f-1cc8-5974-a7f2-174de89c661d
.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/disable-inactiveaduser.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES ActiveDirectory
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Sperrt AD-Benutzer, die sich seit einer bestimmten Zeit nicht angemeldet haben, und verschiebt sie in eine eigene OU.
 
.DESCRIPTION
    Durchsucht eine OU nach aktiven Benutzerkonten und behandelt zwei Fälle:
      1. Letzte Anmeldung liegt länger als -DaysInactive Tage zurück.
      2. Konto hat sich nie angemeldet und wurde vor mehr als -DaysInactive Tagen angelegt.
    Betroffene Konten werden deaktiviert, in -TargetOU verschoben und im Feld "Büro" (physicalDeliveryOfficeName)
    mit Grund und Datum markiert. Am Ende entsteht ein HTML-Bericht, der als Datei gespeichert und auf Wunsch
    per Mail verschickt wird.
 
    Mit -WhatIf lässt sich gefahrlos prüfen, welche Konten betroffen wären.
 
.PARAMETER SearchBase
    Distinguished Name der OU, in der gesucht wird.
 
.PARAMETER TargetOU
    Distinguished Name der OU, in die gesperrte Konten verschoben werden.
 
.PARAMETER DaysInactive
    Anzahl Tage ohne Anmeldung, ab der ein Konto gesperrt wird. Standard: 90.
 
.PARAMETER NameFilter
    Nur Konten, deren SamAccountName auf dieses Muster passt. Standard: *.* (Vorname.Nachname),
    damit Dienst- und Funktionskonten unberührt bleiben.
 
.PARAMETER ReportPath
    Ordner für den HTML-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
    .\Disable-InactiveADUser.ps1 -SearchBase "OU=Benutzer,DC=contoso,DC=local" -TargetOU "OU=Gesperrt,DC=contoso,DC=local" -WhatIf
 
    Zeigt nur an, welche Konten gesperrt würden.
 
.EXAMPLE
    .\Disable-InactiveADUser.ps1 -SearchBase "OU=Benutzer,DC=contoso,DC=local" -TargetOU "OU=Gesperrt,DC=contoso,DC=local" `
        -SmtpServer mail.contoso.local -From ad-report@contoso.local -To it@contoso.local
 
    Sperrt und verschiebt inaktive Konten und schickt den Bericht per Mail.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Hinweis: LastLogonDate basiert auf lastLogonTimestamp und wird nur alle 9 bis 14 Tage repliziert.
             Für Schwellen unter 14 Tagen ist der Wert zu ungenau.
#>

[CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')]
param(
    [Parameter(Mandatory)] [string] $SearchBase,
    [Parameter(Mandatory)] [string] $TargetOU,
    [ValidateRange(14, 3650)] [int] $DaysInactive = 90,
    [string] $NameFilter = '*.*',
    [string] $ReportPath = (Get-Location).Path,
    [string] $SmtpServer,
    [string] $From,
    [string[]] $To
)

Import-Module ActiveDirectory -ErrorAction Stop

$now     = Get-Date
$cutoff  = $now.AddDays(-$DaysInactive)
$stamp   = $now.ToString('dd.MM.yyyy')
$results = [System.Collections.Generic.List[object]]::new()

$users = Get-ADUser -SearchBase $SearchBase -Filter 'Enabled -eq $true' `
    -Properties LastLogonDate, whenCreated, Office |
    Where-Object { $_.SamAccountName -like $NameFilter }

foreach ($user in $users) {
    if ($user.LastLogonDate) {
        if ($user.LastLogonDate -ge $cutoff) { continue }
        $reason = "$DaysInactive Tage inaktiv"
        $since  = $user.LastLogonDate
    }
    elseif ($user.whenCreated -lt $cutoff) {
        $reason = 'Nie angemeldet'
        $since  = $user.whenCreated
    }
    else { continue }

    if ($PSCmdlet.ShouldProcess($user.SamAccountName, "Deaktivieren und nach $TargetOU verschieben ($reason)")) {
        Set-ADUser -Identity $user -Office "[$reason] - $stamp"
        Disable-ADAccount -Identity $user
        Move-ADObject -Identity $user.DistinguishedName -TargetPath $TargetOU
    }

    $results.Add([pscustomobject]@{
        Benutzer      = $user.SamAccountName
        Name          = $user.Name
        Grund         = $reason
        'Seit'        = $since.ToString('dd.MM.yyyy')
        'Tage'        = [int]($now - $since).TotalDays
    })
}

if ($results.Count -eq 0) {
    Write-Host 'Keine inaktiven Konten gefunden.' -ForegroundColor Green
    return
}

$results | Sort-Object Benutzer | Format-Table -AutoSize

$title = "Inaktive Konten - $stamp"
$html  = $results | Sort-Object Grund, Benutzer | ConvertTo-Html -Title $title `
    -PreContent "<h2>$title</h2><p>$($results.Count) Konten, Schwelle $DaysInactive Tage.</p>" | Out-String
$file  = Join-Path $ReportPath ("InaktiveKonten_{0:yyyy-MM-dd}.html" -f $now)
$html | Set-Content -Path $file -Encoding UTF8
Write-Host "Bericht: $file"

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