Manuelles Herunterladen des Pakets

  • Artikel

Der PowerShell-Katalog unterstützt das direkte Herunterladen von Paketen von der Website, ohne dass dazu PowerShellGet-Cmdlets verwendet werden müssen. Sie können jedes Paket als NuGet-Paketdatei (.nupkg) herunterladen, die Sie dann in ein internes Repository kopieren können.

Hinweis

Das manuelle Herunterladen soll nicht als Ersatz für das Install-Module-Cmdlet dienen. Durch das Herunterladen des Pakets werden weder Modul noch Skript installiert. In dem heruntergeladenen NuGet-Paket sind keine Abhängigkeiten enthalten. Die folgenden Anweisungen sollen nur der Referenz dienen.

Manuelles Herunterladen eines Pakets

Auf jeder Seite gibt es einen Link zum manuellen Download:

Paketseite mit Installationsoptionen

Klicken Sie auf Download the raw nupkg file (NUPKG-Rohdatei herunterladen), um das Paket manuell herunterzuladen. Eine Kopie des Pakets mit dem Namen <name>.<version>.nupkg wird in den Downloadordner Ihres Browsers heruntergeladen.

Ein NuGet-Paket ist ein ZIP-Archiv mit zusätzlichen Dateien, die Informationen zum Inhalt des Pakets enthalten. Einige Browser, wie z.B. auch Internet Explorer, ersetzen die Erweiterung .nupkg automatisch durch .zip. Benennen Sie die .nupkg-Datei bei Bedarf in eine .zip-Datei um, um das Paket zu erweitern, und entpacken Sie dann den Inhalt in einen lokalen Ordner.

Eine NuGet-Paketdatei enthält die folgenden NuGet-spezifischen Elemente, die nicht Teil des ursprünglichen gepackten Codes sind:

  • Einen Ordner mit dem Namen _rels. Dieser enthält eine .rels-Datei, in der die Abhängigkeiten aufgelistet sind.
  • Einen Ordner mit dem Namen package. Dieser enthält NuGet-spezifische Daten.
  • Eine Datei mit dem Namen [Content_Types].xml. In dieser wird beschrieben, wie Erweiterungen wie PowerShellGet mit NuGet funktionieren.
  • Eine Datei mit dem Namen <name>.nuspec. Diese enthält die meisten Metadaten.

Installieren von PowerShell-Modulen aus einem NuGet-Paket

Hinweis

Diese Schritte führen nicht zu dem gleichen Ergebnis wie das Ausführen von Install-Module. Diese Anweisungen erfüllen die Mindestanforderungen. Sie sollen nicht als Ersatz für Install-Module dienen. Einige Schritte, die von Install-Module durchgeführt werden, sind nicht vorhanden.

Am unkompliziertesten ist es, die NuGet-spezifischen Elemente aus dem Ordner zu entfernen. Nach dem Entfernen der Elemente bleibt der vom Paketautor erstellte PowerShell-Code übrig. Eine Liste der NuGet-spezifischen Elemente finden Sie unter Manuelles Herunterladen eines Pakets.

Die Schritte lauten wie folgt:

  1. Heben Sie die Blockierung der aus dem Internet heruntergeladenen NuGet-Paketdatei (.nupkg) auf, z. B. mit dem Cmdlet Unblock-File -Path C:\Downloads\module.nupkg.
  2. Entpacken Sie den Inhalt des NuGet-Pakets in einen lokalen Ordner.
  3. Löschen Sie die NuGet-spezifischen Elemente aus dem Ordner.
  4. Benennen Sie den Ordner um. Der Standardname des Ordners ist für gewöhnlich <name>.<version>. Die Version kann -prerelease enthalten, wenn das Modul als Vorabversion gekennzeichnet ist. Benennen Sie den Ordner in den Modulnamen um. azurerm.storage.5.0.4-preview wird beispielsweise zu azurerm.storage.
  5. Kopieren Sie den Ordner in einen der Ordner in $env:PSModulePath value. $env:PSModulePath ist eine durch Semikolons getrennte Reihe von Pfaden, in denen PowerShell nach Modulen suchen soll.

Wichtig

Beim manuellen Download werden keine Abhängigkeiten heruntergeladen, die für das Modul erforderlich sind. Wenn das Paket über Abhängigkeiten verfügt, müssen diese auf dem System installiert werden, damit das Modul ordnungsgemäß funktioniert. Der PowerShell-Katalog zeigt alle Abhängigkeiten an, die für das Paket erforderlich sind.

Installieren von PowerShell-Skripts aus einem NuGet-Paket

Hinweis

Diese Schritte führen nicht zu dem gleichen Ergebnis wie das Ausführen von Install-Script. Diese Anweisungen erfüllen die Mindestanforderungen. Sie sollen nicht als Ersatz für Install-Script dienen.

Es ist am unkompliziertesten, das NuGet-Paket zu entpacken und das Skript dann direkt zu verwenden.

Die Schritte lauten wie folgt:

  1. Heben Sie die Blockierung der aus dem Internet heruntergeladenen NuGet-Paketdatei (.nupkg) auf, z. B. mit dem Cmdlet Unblock-File -Path C:\Downloads\package.nupkg.
  2. Entpacken Sie den Inhalt des NuGet-Pakets.
  3. Die .PS1-Datei im Ordner kann direkt von dort verwendet werden.
  4. Sie können die NuGet-spezifischen Elemente aus dem Ordner löschen.

Eine Liste der NuGet-spezifischen Elemente finden Sie unter Manuelles Herunterladen eines Pakets.

Wichtig

Beim manuellen Download werden keine Abhängigkeiten heruntergeladen, die für das Modul erforderlich sind. Wenn das Paket über Abhängigkeiten verfügt, müssen diese auf dem System installiert werden, damit das Modul ordnungsgemäß funktioniert. Der PowerShell-Katalog zeigt alle Abhängigkeiten an, die für das Paket erforderlich sind.