Remove Eulanda Xtools Old Version
Zuletzt geändert: 21.11.2026 18:22

Übersicht

Remove-EulandaXtoolsOldVersion #

ÜBERSICHT #

Entfernt ältere Versionsordner von EulandaXtools, sobald die neueste Fassung nachweislich vollständig installiert ist.

SYNTAX #

Remove-EulandaXtoolsOldVersion [[-Root] <string[]>] [[-MinAgeMinutes] <int>] [[-LogPath] <string>]
    [-AllowUnsigned] [-SkipImport]

BESCHREIBUNG #

Jeder liegengebliebene Versionsordner, dessen Manifest die Funktionen mit Stern exportiert (alle Fassungen bis 1.0.428), kostet in Windows PowerShell 5.1 rund 0,27 Sekunden je neuem PowerShell-Prozess. Mit sechs alten Ordnern dauert eine E-Rechnung 5,1 statt 3,4 Sekunden (Messung 21.11.2026). Beim Kunden soll deshalb nur die neueste Fassung liegen bleiben (CN, 21.11.2026).

Die Reihenfolge ist zwingend: erst die neue Fassung prüfen, dann die alten entfernen. Die neueste Fassung je Modulpfad muss Test-EulandaModuleIntegrity bestehen (alle Dateien laut Dateiliste vorhanden und unverändert, Manifest und Modul gültig signiert, Probe-Import in einem frischen Prozess mit erwarteter Version und Funktionszahl). Besteht sie nicht, wird in diesem Modulpfad nichts gelöscht; die bisherigen Fassungen bleiben benutzbar. Fassungen bis 1.0.429 tragen keine Dateiliste und können deshalb nie der Anlass zum Aufräumen sein.

Stehen bleibt immer:

  • die neueste Fassung;
  • 1.0.4: bei einem Kunden läuft ein altes EDI-Modul, das nur damit geht;
  • alles unter 1.0.4 (das räumt Remove-EulandaXtoolsLegacyVersion weg);
  • eine Verknüpfung (Junction oder Symlink), etwa eines Entwicklers;
  • die im eigenen Prozess geladene Fassung;
  • ein Ordner ohne Manifest oder mit abweichender ModuleVersion (nur gemeldet).

Ein alter Ordner wird zuerst umbenannt und dann gelöscht. Hält ein laufender Prozess darin eine Datei offen (etwa eine geladene DLL), scheitert schon das Umbenennen, der Ordner bleibt unversehrt und steht unter Failed; der nächste Lauf versucht es wieder. So entsteht nie ein halb gelöschter Ordner, den PowerShell noch als Modul ansieht.

Aufgeräumt wird nur in den Modulpfaden des Benutzers, ohne Administratorrechte. Die Funktion wirft nicht.

PARAMETER #

-Root #

Type: string[]

Modulwurzeln, in denen aufgeräumt wird. Vorgabe: die beiden Benutzer-Modulpfade aus Get-UserPs5ModulePath und Get-UserPs7ModulePath.

-MinAgeMinutes #

Type: int
Default: 0

Die neueste Fassung muss mindestens so viele Minuten installiert sein, bevor die älteren weichen. Vorgabe 0. Ein Wert größer null fängt eine Quarantäne ab, die erst verzögert zuschlägt.

-LogPath #

Type: string
Default: ''

Datei, an die das Protokoll angehängt wird (UTF-8). Leer = kein Protokoll, nur -Verbose.

-AllowUnsigned #

Type: switch

Die Signaturprüfung der neuesten Fassung auslassen (Tests).

-SkipImport #

Type: switch

Den Probe-Import der neuesten Fassung auslassen (Tests).

AUSGABEN #

pscustomobject

Removed (entfernte Ordner), Reported (nur gemeldet, mit Grund), Failed (Löschen gescheitert, mit Grund).

BEISPIELE #

Remove-EulandaXtoolsOldVersion -WhatIf

Zeigt, welche Ordner entfernt würden.
$r = Remove-EulandaXtoolsOldVersion -LogPath "$env:TEMP\xtools-cleanup.log"
$r.Removed