Move-LeaverFolder.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 9942a662-11c5-5210-9b6f-b22cdb9463c3
.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-leaverfolder.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES ActiveDirectory
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Archiviert Home-, Profil- und PST-Ordner ausgeschiedener Mitarbeitender und entfernt ihre Gruppenmitgliedschaften.
 
.DESCRIPTION
    Liest alle Benutzer aus der OU für ausgeschiedene Mitarbeitende. Für jeden Benutzer wird in jedem
    angegebenen Stammordner geprüft, ob ein Ordner mit seinem Anmeldenamen existiert. Gefundene Ordner werden
    in einen Unterordner (Standard: _Ausgeschiedene) im selben Stammordner verschoben.
    Mit -RemoveGroups werden zusätzlich alle Gruppenmitgliedschaften außer der primären Gruppe entfernt.
 
    Alle Aktionen landen in einer Protokolldatei. -WhatIf zeigt vorher, was passieren würde.
 
.PARAMETER SearchBase
    Distinguished Name der OU mit den ausgeschiedenen Benutzern.
 
.PARAMETER RootPath
    Ein oder mehrere Stammordner, zum Beispiel Home-, Profil- und PST-Freigabe.
 
.PARAMETER ArchiveFolderName
    Name des Archivordners innerhalb jedes Stammordners. Standard: _Ausgeschiedene
 
.PARAMETER RemoveGroups
    Entfernt zusätzlich alle Gruppenmitgliedschaften der Benutzer.
 
.PARAMETER LogPath
    Pfad der Protokolldatei. Standard: Move-LeaverFolder.log im aktuellen Ordner.
 
.EXAMPLE
    .\Move-LeaverFolder.ps1 -SearchBase "OU=Ausgeschieden,DC=contoso,DC=local" `
        -RootPath \\fs01\home$, \\fs01\profile$, \\fs01\pst$ -RemoveGroups -WhatIf
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Profilordner tragen je nach System eine Endung wie .V6. Solche Ordner werden über das Muster
    "<Anmeldename>*" mit erfasst.
#>

[CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')]
param(
    [Parameter(Mandatory)] [string] $SearchBase,
    [Parameter(Mandatory)] [string[]] $RootPath,
    [string] $ArchiveFolderName = '_Ausgeschiedene',
    [switch] $RemoveGroups,
    [string] $LogPath = (Join-Path (Get-Location).Path 'Move-LeaverFolder.log')
)

Import-Module ActiveDirectory -ErrorAction Stop

function Write-LeaverLog([string] $Message) {
    $line = '{0:yyyy-MM-dd HH:mm:ss} {1}' -f (Get-Date), $Message
    Write-Host $line
    if (-not $WhatIfPreference) { Add-Content -Path $LogPath -Value $line -Encoding UTF8 }
}

$users = Get-ADUser -SearchBase $SearchBase -Filter * -Properties MemberOf

foreach ($user in $users) {
    $name = $user.SamAccountName

    foreach ($root in $RootPath) {
        $archive = Join-Path $root $ArchiveFolderName
        Get-ChildItem -Path $root -Directory -Filter "$name*" -ErrorAction SilentlyContinue |
            Where-Object { $_.Name -eq $name -or $_.Name -like "$name.V*" } |
            ForEach-Object {
                if ($PSCmdlet.ShouldProcess($_.FullName, "Verschieben nach $archive")) {
                    if (-not (Test-Path $archive)) { New-Item -Path $archive -ItemType Directory | Out-Null }
                    Move-Item -Path $_.FullName -Destination $archive
                    Write-LeaverLog "$name $($_.FullName) -> $archive"
                }
            }
    }

    if ($RemoveGroups -and $user.MemberOf) {
        foreach ($group in $user.MemberOf) {
            if ($PSCmdlet.ShouldProcess($name, "Aus Gruppe entfernen: $group")) {
                Remove-ADGroupMember -Identity $group -Members $user -Confirm:$false
                Write-LeaverLog "$name Gruppe entfernt: $group"
            }
        }
    }
}