Invoke-XSetup

ÜBERSICHT

Installiert oder aktualisiert ein Artefakt (Module oder Script) aus Repo (Web/Folder).

SYNTAX

Invoke-XSetup [[-MinVersion] <string>] [[-MaxVersion] <string>] [[-AppType] <string>] [-AppName]
    <string> [[-Base] <string>] [[-ArtifactName] <string>] [-Overwrite] [-UpdateNewest]
    [<CommonParameters>]

BESCHREIBUNG

Module:

ArtifactName standardmässig .zip, installiert nach ...\Modules\\\
Die installierte Version wird über Get-LatestModuleVersion am Modulpfad ermittelt (.psm1)

Script:

ArtifactName ist immer .zip
Im ZIP liegt eine Datei .ps1 (keine Unterordner)
Ziel ist ...\WindowsPowerShell\Scripts\.ps1
installierte Version wird aus dem PSScriptInfo-Header der Zieldatei gelesen

Min/Max steuern die akzeptierte/gesuchte Version. Lokale Quelle ($PSScriptRoot\\) hat Vorrang. Diese muss dann auch die Versions-Unterordner enthalten.

PARAMETER

-MinVersion

Type: string

Die minimale Version, die akzeptiert wird (z.B. '1.0.3').

-MaxVersion

Type: string

Die maximale Version, die akzeptiert wird (z.B. '1.0.99').

-AppType

Type: string
Default: 'Module'

Kann `Module' oder `Script`enthalten. Der Default ist `Module`.

-AppName

Type: string

Der Name des zu installierenden Moduls bzw. Skrips (z.B. 'EulandaXTools' bei Modulen oder 'xrechnung' bei Skripts). Hierzu gibt es die Aliase ModuleName und ScriptName.

-Base

Type: string
Default: "https://files.eulanda.eu/apps/$AppName/"

Basis-URL oder lokaler Pfad, von dem Modulversionen abgerufen werden. Der Pfad muss Versionen als Unterordner beinhalten.

-ArtifactName

Type: string
Default: "$($Appname).zip"

Name der ZIP-Datei des Moduls bzw. Skripts. Standardmäßig ".zip".

-Overwrite

Type: switch

Erzwingt die Installation, auch wenn die Zielversion bereits existiert.

-UpdateNewest

Type: switch

Aktualisiert das Modul, falls lokal eine ältere Version vorhanden ist, auf die neueste verfügbare innerhalb der Versionsgrenzen.

BEISPIELE

# Installiert das Modul "EulandaXTools" lokal oder remote, mindestens Version 1.0.3 bis maximal 1.0.99.
Invoke-XSetup -MinVersion '1.0.3' -MaxVersion '1.0.99' -AppType Module -ModuleName 'EulandaXTools'

# Installiert das Skript "xrechnung" lokal oder remote, mindestens Version 3.49.1 bis maximal 3.49.99.
Invoke-XSetup -MinVersion '3.49.1' -MaxVersion '3.49.99' -AppType Script -ScriptName 'xrechnung'

# ruft das Script XSetup.ps1 auf und installiert das Modul "EulandaXTools" lokal oder remote, mindestens Version 1.0.3 bis maximal 1.0.99.
powershell.exe -ExecutionPolicy Bypass -File .\XSetup.ps1 -MinVersion 1.0.3 -MaxVersion 1.0.99 -AppType Module -ModuleName 'EulandaXTools'

# Erzwingt die erneute Installation der aktuellen Version des Moduls.
Invoke-XSetup -MinVersion '1.0.3' -MaxVersion '1.0.99' -AppType Module -ModuleName 'EulandaXTools' -Overwrite

# Installiert oder aktualisiert auf die neueste verfügbare Version innerhalb des Bereichs.
Invoke-XSetup -MinVersion '1.0.3' -MaxVersion '1.0.99' -AppType Module -ModuleName 'EulandaXTools' -UpdateNewest

# Installiert en Modul aus einer Kommadozeile heraus, bei dem Invoke-XSetup in einem Script eingebettet ist, das identische Eingangsparameter enthält, sowie die notwendigen Hilfsfunktionen Get-LatestModuleVersion, Get-UserPs5ModulPath und Install-AppFromRepository.
powershell.exe -ExecutionPolicy Bypass -File .\XSetup.ps1 -MinVersion 1.0.3 -MaxVersion 1.0.99 -AppType Module -ModuleName 'EulandaXTools'

HINWEISE

Die Funktion verwendet semantische Versionierung zur Versionsauswahl und bevorzugt bei Verfügbarkeit lokale Quellen, bevor sie auf Remotequellen zugreift. Standardmäßig erfolgt kein Überschreiben bestehender Installationen.