Ręczne pobieranie pakietów

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.

Uwaga

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

Korzystanie z ręcznego pobierania w celu uzyskania pakietu

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

Strona wyświetlania pakietu z opcjami instalacji

Aby pobrać ręcznie, kliknij pozycję Pobierz nieprzetworzonego pliku nupkg. Kopia pakietu jest kopiowana do folderu pobierania dla 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ą .nupkg rozszerzenie pliku ..zip Aby rozwinąć pakiet, zmień nazwę .nupkg pliku na .zip, jeśli jest to konieczne, a następnie wyodrębnij zawartość do folderu lokalnego.

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

  • Folder o nazwie _rels — zawiera .rels plik zawierający listę zależności
  • Folder o nazwie package — zawiera dane specyficzne dla narzędzia NuGet
  • Plik o nazwie [Content_Types].xml — opisuje, jak rozszerzenia, takie jak PowerShellGet, działają z pakietem NuGet
  • Plik o nazwie <name>.nuspec — zawiera większość metadanych

Instalowanie modułów programu PowerShell z pakietu NuGet

Uwaga

Te instrukcje nie dają tego samego wyniku co uruchomienie polecenia Install-Module. Te instrukcje spełniają minimalne wymagania. Nie są one przeznaczone do zastąpienia dla Install-Module. Niektóre kroki wykonywane przez Install-Module program nie są uwzględniane.

Najprostszym podejściem jest usunięcie elementów specyficznych dla narzędzia NuGet z folderu. Usunięcie elementów pozostawia kod programu PowerShell utworzony przez autora pakietu. Aby zapoznać się z listą elementów specyficznych dla narzędzia NuGet, zobacz Używanie ręcznego pobierania do uzyskania pakietu.

Kroki tego procesu są następujące:

  1. Odblokuj pobrany z Internetu plik pakietu NuGet (.nupkg), na przykład przy użyciu Unblock-File -Path C:\Downloads\module.nupkg polecenia cmdlet.
  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ł jest oznaczony 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 folderze $env:PSModulePath value. $env:PSModulePath to rozdzielany średnikami zestaw ścieżek, w których program PowerShell powinien szukać modułów.

Ważne

Pobieranie ręczne nie obejmuje ż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 pokazuje wszystkie zależności wymagane przez pakiet.

Instalowanie skryptów programu PowerShell z pakietu NuGet

Uwaga

Te instrukcje nie dają tego samego wyniku co uruchomienie polecenia Install-Script. Te instrukcje spełniają minimalne wymagania. Nie są one przeznaczone do zastąpienia dla Install-Script.

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

Kroki tego procesu są następujące:

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

Aby zapoznać się z listą elementów specyficznych dla narzędzia NuGet, zobacz Używanie ręcznego pobierania do uzyskania pakietu.

Ważne

Pobieranie ręczne nie obejmuje ż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 pokazuje wszystkie zależności wymagane przez pakiet.