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