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
}