Install-ModuleFromZip

ÜBERSICHT

Installiert ein PowerShell-Modul aus einer ZIP-Datei in den Modulpfad.

SYNTAX

Install-ModuleFromZip [-Path] <string> [[-Scope] <string>] [-Force] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion installiert ein PowerShell-Modul aus einer bereitgestellten ZIP-Datei. Die Modulversion wird aus der `.psd1`-Datei im ZIP-Archiv ermittelt (nur diese eine Datei wird dafür temporär extrahiert).

• Danach wird geprüft, ob diese Version bereits vorhanden ist; falls ja und der Schalter `-Force` nicht gesetzt ist, wird keine Aktion durchgeführt.
• Wird der Schalter `-Force` verwendet, wird die bestehende Version gelöscht und durch die neue ersetzt.
• Ist die Version noch nicht vorhanden, wird das Modul in den User-Modulpfad entpackt.

Der Installationsort richtet sich nach dem gewählten Scope `CurrentUser`. Dies kann das physikalische Laufwerk sein, oder aber beispielsweise ein OneDrive-Ordner. Dies wäre der Fall wenn bei OneDrive die Option verwendet wurde, die persönlichen Ordner in der Cloud zu speichern. Der Ort des Benutzerpfads wird über `Get-UserModulPath` ermittelt.

Die Funktion gibt `TRUE` zurück, wenn die Installation erfolgreich durchgeführt wurde, oder `FALSE` bei technischen Problemen wie beispielsweise Schreib- oder Löschfehler.

PARAMETER

-Path

Type: string

Pfad zur ZIP-Datei, die das zu installierende Modul enthält.

-Scope

Type: string
Default: "CurrentUser"

Optional. Gibt den Installationsbereich des Moduls an, aktuell nur einen.

Möglich sind:

• CurrentUser (Standard): Installiert das Modul nur für den aktuellen Benutzer.

-Force

Type: switch

Wenn angegeben, wird die vorhandene Version entfernt und neu installiert, auch wenn sie bereits vorhanden ist.

AUSGABEN

bool

Gibt `TRUE` zurück bei erfolgreicher Installation, sonst `FALSE`.

BEISPIELE

# Installiert das Modul aus der angegebenen ZIP-Datei in den aktuellen Benutzerbereich.
Install-ModuleFromZip -Path 'C:\Downloads\MeinModul.zip'

# Erzwingt eine Neuinstallation, selbst wenn die Version bereits existiert.
Install-ModuleFromZip -Path 'C:\Downloads\MeinModul.zip' -Force

HINWEISE

• Benötigt eine Hilfsfunktion `Get-UserPs5ModulePath`, um den Zielpfad basierend auf dem Scope zu ermitteln.
• Temporäre Dateien werden nach Abschluss der Installation automatisch bereinigt.