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