Udostępnij za pośrednictwem

Pobieranie pakietów ręcznych

  • Artykuł

Galeria programu PowerShell obsługuje bezpośrednie pobieranie pakietu z witryny internetowej bez używania poleceń cmdlet PowerShellGet. Możesz pobrać dowolny pakiet jako plik pakietu NuGet (.nupkg), który następnie można skopiować do wewnętrznego repozytorium.

Nuta

Pobieranie pakietów ręcznych nie jest przeznaczone jako zamiennik polecenia cmdlet Install-Module. Pobranie pakietu nie powoduje zainstalowania modułu ani skryptu. Zależności nie są uwzględniane w pobranym pakiecie NuGet. Poniższe instrukcje są udostępniane tylko do celów referencyjnych.

Korzystanie z ręcznego pobierania w celu uzyskania pakietu

Każda strona ma link do ręcznego pobierania, jak pokazano poniżej:

strona wyświetlania pakietu z opcjami instalacji

Aby pobrać ręcznie, kliknij pozycję Pobierz nieprzetworzone pliki nupkg. Kopia pakietu jest kopiowana do folderu pobierania przeglądarki o nazwie <name>.<version>.nupkg.

Pakiet NuGet to archiwum ZIP z dodatkowymi plikami zawierającymi informacje o zawartości pakietu. Niektóre przeglądarki, takie jak Internet Explorer, automatycznie zastępują rozszerzenie .nupkg pliku .zip. Aby rozwinąć pakiet, zmień nazwę pliku .nupkg na .zip, w razie potrzeby, a następnie wyodrębnij zawartość do folderu lokalnego przy użyciu Expand-Archive lub innego narzędzia do plików ZIP.

Plik pakietu NuGet zawiera następujące elementów specyficznych dla pakietu NuGet, które nie są częścią oryginalnego spakowanego kodu:

  • Folder o nazwie _rels — zawiera plik .rels zawierający listę zależności
  • Folder o nazwie package — zawiera dane specyficzne dla pakietu NuGet
  • Plik o nazwie [Content_Types].xml — opisuje sposób działania rozszerzeń, takich jak PowerShellGet z pakietem NuGet
  • Plik o nazwie <name>.nuspec — zawiera większość metadanych

Instalowanie modułów programu PowerShell z pakietu NuGet

Nuta

Te instrukcje nie dają taki sam wynik jak uruchomienie Install-Module. Te instrukcje spełniają minimalne wymagania. Nie są one przeznaczone do zastąpienia Install-Module. Niektóre kroki wykonywane przez Install-Module nie są uwzględniane.

Najprostszym podejściem jest usunięcie elementów specyficznych dla pakietu NuGet z folderu. Usunięcie elementów pozostawia kod programu PowerShell utworzony przez autora pakietu. Aby uzyskać listę elementów specyficznych dla pakietu NuGet, zobacz Using manual download to acquire a package.

Kroki są następujące:

  1. Odblokuj pobrany z Internetu plik pakietu NuGet (.nupkg), na przykład przy użyciu polecenia cmdlet Unblock-File -Path C:\Downloads\module.nupkg.
  2. Wyodrębnij zawartość pakietu NuGet do folderu lokalnego.
  3. Usuń elementy specyficzne dla narzędzia NuGet z folderu.
  4. Zmień nazwę folderu. Domyślna nazwa folderu to zwykle <name>.<version>. Wersja może zawierać -prerelease, jeśli moduł zostanie otagowany jako wersja wstępna. Zmień nazwę folderu na tylko nazwę modułu. Na przykład azurerm.storage.5.0.4-preview staje się azurerm.storage.
  5. Skopiuj folder do jednego z folderów w $env:PSModulePath value. $env:PSModulePath to rozdzielany średnikami zestaw ścieżek, w których program PowerShell powinien szukać modułów.

Ważny

Pobieranie ręczne nie zawiera żadnych zależności wymaganych przez moduł. Jeśli pakiet ma zależności, należy je zainstalować w systemie, aby ten moduł działał poprawnie. Galeria programu PowerShell zawiera wszystkie zależności wymagane przez pakiet.

Instalowanie skryptów programu PowerShell z pakietu NuGet

Nuta

Te instrukcje nie dają taki sam wynik jak uruchomienie Install-Script. Te instrukcje spełniają minimalne wymagania. Nie są one przeznaczone do zastąpienia Install-Script.

Najprostszym podejściem jest wyodrębnienie pakietu NuGet, a następnie użycie skryptu bezpośrednio.

Kroki są następujące:

  1. Odblokuj pobrany z Internetu plik pakietu NuGet (.nupkg), na przykład przy użyciu polecenia cmdlet Unblock-File -Path C:\Downloads\package.nupkg.
  2. Wyodrębnij zawartość pakietu NuGet.
  3. Plik .PS1 w folderze może być używany bezpośrednio z tej lokalizacji.
  4. Możesz usunąć elementy specyficzne dla nuGet w folderze.

Aby uzyskać listę elementów specyficznych dla pakietu NuGet, zobacz Using manual download to acquire a package.

Ważny

Pobieranie ręczne nie zawiera żadnych zależności wymaganych przez moduł. Jeśli pakiet ma zależności, należy je zainstalować w systemie, aby ten moduł działał poprawnie. Galeria programu PowerShell zawiera wszystkie zależności wymagane przez pakiet.