Install Module From Zip
Zuletzt geändert: 14.03.2026 05:56

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.