Test-EulandaModuleIntegrity #
ÜBERSICHT #
Prüft, ob ein installierter Versionsordner eines Moduls vollständig, unverändert, signiert und ladbar ist.
SYNTAX #
Test-EulandaModuleIntegrity [-Path] <string> [[-Name] <string>] [-AllowUnsigned] [-SkipImport]
[[-TimeoutSec] <int>] [<CommonParameters>]
BESCHREIBUNG #
Ein Versionsordner, der nur existiert, ist noch nicht installiert: Ein Virenscanner kann einzelne Dateien nachträglich entfernen oder in Quarantäne legen (bekannt ist der Fehlalarm von Defender auf die PSM1), ein abgebrochenes Kopieren hinterlässt halbe Ordner. Diese Funktion stellt fest, ob die Fassung wirklich benutzbar ist. Erst danach dürfen ältere Fassungen weg (Remove-EulandaXtoolsOldVersion).
Geprüft wird der Reihe nach:
- Manifest und Wurzelmodul liegen vor, die
ModuleVersionpasst zum Ordnernamen. - Die Dateiliste
filelist.sha256liegt vor (der Builder schreibt sie seit EulandaXtools 1.0.430 ins Paket), und jede dort genannte Datei ist vorhanden und hat die genannte SHA-256-Prüfsumme. Ohne Dateiliste gilt die Fassung als nicht bestätigt. - Manifest und Wurzelmodul tragen eine gültige Authenticode-Signatur.
- Das Modul lässt sich in einem frischen PowerShell-Prozess über den Manifest-Pfad importieren, meldet die erwartete Version und, wenn das Manifest die Funktionen ausdrücklich aufzählt, genau so viele Befehle.
Die Funktion wirft nicht. Jede Abweichung steht als Klartext in Problems, Ok ist nur ohne Abweichung wahr.
PARAMETER #
-Path #
Type: string
Der Versionsordner, zum Beispiel ...\Modules\EulandaXtools\1.0.430.
-Name #
Type: string
Default: 'EulandaXtools'
Modulname. Vorgabe EulandaXtools.
-AllowUnsigned #
Type: switch
Die Signaturprüfung auslassen (Tests, Entwicklerstände). Beim Kunden nicht verwenden.
-SkipImport #
Type: switch
Den Probe-Import im frischen Prozess auslassen.
-TimeoutSec #
Type: int
Default: 120
Zeitlimit für den Probe-Import in Sekunden. Vorgabe 120.
AUSGABEN #
pscustomobject
Path, Name, Version, Ok, FileCount, Problems.
BEISPIELE #
Test-EulandaModuleIntegrity -Path (Get-Module EulandaXtools).ModuleBase
Prüft die gerade geladene Fassung.
$r = Test-EulandaModuleIntegrity -Path "$(Get-UserPs5ModulePath)\EulandaXtools\1.0.430"
if (-not $r.Ok) { $r.Problems }