Move-DisabledADUser.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID 74682485-17c0-5a44-af8f-734499f83149 .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/move-disabledaduser.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES ActiveDirectory .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Verschiebt deaktivierte AD-Benutzer, die länger nicht angemeldet waren, in eine Archiv-OU. .DESCRIPTION Sucht in einer OU nach deaktivierten Benutzerkonten, deren letzte Anmeldung länger als -DaysInactive Tage zurückliegt. Diese Konten werden in -TargetOU verschoben und im Feld "Büro" mit dem Datum markiert. So bleiben die aktiven OUs aufgeräumt, und die Konten lassen sich später gesammelt prüfen und löschen. .PARAMETER SearchBase Distinguished Name der OU, in der gesucht wird. .PARAMETER TargetOU Distinguished Name der Archiv-OU. .PARAMETER DaysInactive Mindestanzahl Tage seit der letzten Anmeldung. Standard: 90. .PARAMETER NameFilter Nur Konten, deren SamAccountName auf dieses Muster passt. Standard: *.* .PARAMETER SmtpServer Optional. Mailserver für den Bericht. .PARAMETER From Absender des Berichts. .PARAMETER To Empfänger des Berichts. .EXAMPLE .\Move-DisabledADUser.ps1 -SearchBase "OU=Benutzer,DC=contoso,DC=local" -TargetOU "OU=Archiv,DC=contoso,DC=local" -WhatIf .NOTES Autor: Torsten Weise, powerscripting.de #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')] param( [Parameter(Mandatory)] [string] $SearchBase, [Parameter(Mandatory)] [string] $TargetOU, [ValidateRange(1, 3650)] [int] $DaysInactive = 90, [string] $NameFilter = '*.*', [string] $SmtpServer, [string] $From, [string[]] $To ) Import-Module ActiveDirectory -ErrorAction Stop $now = Get-Date $cutoff = $now.AddDays(-$DaysInactive) $stamp = $now.ToString('dd.MM.yyyy') $moved = Get-ADUser -SearchBase $SearchBase -Filter 'Enabled -eq $false' -Properties LastLogonDate | Where-Object { $_.SamAccountName -like $NameFilter -and $_.LastLogonDate -and $_.LastLogonDate -lt $cutoff } | ForEach-Object { if ($PSCmdlet.ShouldProcess($_.SamAccountName, "Nach $TargetOU verschieben")) { Set-ADUser -Identity $_ -Office "[Deaktiviert, archiviert] - $stamp" Move-ADObject -Identity $_.DistinguishedName -TargetPath $TargetOU } [pscustomobject]@{ Benutzer = $_.SamAccountName Name = $_.Name 'Letzte Anmeldung' = $_.LastLogonDate.ToString('dd.MM.yyyy') } } if (-not $moved) { Write-Host 'Keine deaktivierten Konten zum Verschieben gefunden.' -ForegroundColor Green return } $moved | Sort-Object Benutzer | Format-Table -AutoSize if ($SmtpServer -and $From -and $To -and -not $WhatIfPreference) { $title = "Archivierte Konten - $stamp" $html = $moved | Sort-Object Benutzer | ConvertTo-Html -Title $title -PreContent "<h2>$title</h2>" | Out-String Send-MailMessage -SmtpServer $SmtpServer -From $From -To $To -Subject $title -Body $html -BodyAsHtml -Encoding UTF8 } |