Install-Module kończy się błędem

Install-Module kończy się błędem wskazuje na brak dostępu do repozytorium PowerShell Gallery lub nieaktualny dostawca NuGet wymagany do pobrania modułu.

Install-Module kończy się błędem — co oznacza ten komunikat

Polecenie Install-Module służy do pobierania i instalowania modułów PowerShell z określonego źródła pakietów, najczęściej z PowerShell Gallery. Gdy wykonanie polecenia kończy się błędem, nie musi to oznaczać uszkodzenia samego modułu. Przyczyną może być problem z odnalezieniem repozytorium, brak zaufania do źródła, niedostępna sieć, nieprawidłowe ustawienia dostawcy pakietów albo niewłaściwa konfiguracja używanej wersji PowerShell.

W praktyce znaczenie błędu zależy od jego treści. Inaczej interpretuje się komunikat o braku dostawcy NuGet, inaczej informację o niedostępnej galerii, a jeszcze inaczej ostrzeżenie dotyczące niezaufanego repozytorium. Znaczenie ma również to, czy polecenie jest uruchamiane w Windows PowerShell, czy w nowszym PowerShell, a także czy instalacja odbywa się dla bieżącego użytkownika, czy dla wszystkich użytkowników komputera.

Repozytorium, dostawca pakietów i zgodność środowiska

Instalacja modułu przebiega przez kilka zależnych elementów. Najpierw PowerShell musi znać adres repozytorium i mieć możliwość nawiązania z nim połączenia. Następnie wymagany jest dostawca obsługujący odpowiedni format pakietów, zwykle NuGet. Na końcu pobierany jest moduł wraz z metadanymi i ewentualnymi zależnościami. Awaria dowolnego etapu może zostać zgłoszona jako błąd polecenia Install-Module, mimo że sam moduł pozostaje poprawnie opublikowany.

Jednym z często spotykanych powodów jest nieaktualny dostawca NuGet albo konfiguracja używająca starszego protokołu zabezpieczeń. W takim przypadku dostęp do repozytorium może być odrzucany, ponieważ połączenie nie spełnia wymagań serwera. Problem może również wynikać z ustawień proxy, filtrowania ruchu przez zaporę, kontroli certyfikatów lub ograniczeń obowiązujących w danej sieci.

Przed zmianą konfiguracji warto sprawdzić zdefiniowane źródła poleceniem Get-PSRepository, a także zweryfikować, czy repozytorium jest oznaczone jako zaufane i czy odpowiada na żądania. Pomocne bywa również jawne wskazanie parametru -Repository, ponieważ pozwala wykluczyć sytuację, w której PowerShell próbuje korzystać z niewłaściwego lub nieaktywnego źródła. Jeżeli moduł ma być dostępny tylko dla bieżącego konta, można rozważyć zakres instalacji określany parametrem -Scope CurrentUser.

Typowe problemy podczas instalowania modułu

Błąd może pojawić się już przy wyszukiwaniu modułu, gdy nazwa została wpisana niepoprawnie, repozytorium nie działa albo lokalna konfiguracja nie zawiera właściwego źródła. Warto odróżnić brak wyników wyszukiwania od odmowy dostępu. Pierwszy przypadek może wskazywać na literówkę, inną nazwę publikowanego modułu lub niewłaściwą galerię. Drugi częściej wiąże się z uprawnieniami, uwierzytelnianiem, proxy albo polityką bezpieczeństwa.

Inny wariant dotyczy dostawcy NuGet. Gdy nie jest zainstalowany, jest uszkodzony lub ma zbyt starą wersję, PowerShell może nie być w stanie pobrać modułu mimo prawidłowego połączenia z Internetem. Czasem pojawia się także pytanie o instalację dostawcy albo ostrzeżenie dotyczące repozytorium. Brak reakcji na taki monit, uruchomienie konsoli bez wymaganych uprawnień lub ograniczenia polityki wykonywania skryptów mogą przerwać procedurę.

Do problemów zalicza się również konflikt wersji. Starszy moduł może wymagać określonej wersji PowerShell, bibliotek systemowych albo innych modułów. Zainstalowanie nowej wersji bez sprawdzenia zależności może spowodować konflikt z wersją już obecną w systemie. Przed ponowieniem instalacji należy odczytać pełny komunikat, sprawdzić polecenie Get-Module -ListAvailable i ustalić, czy problem dotyczy pobierania, rozpakowania, importu, czy dopiero uruchomienia modułu.

Nie powinno się bez wyjaśnienia usuwać katalogów modułów ani wielokrotnie wymuszać instalacji. Takie działania mogą utrudnić ustalenie przyczyny, pozostawić częściowo pobrane pliki lub doprowadzić do pomieszania wersji. Bezpieczniejsze jest zapisanie pełnego błędu, sprawdzenie konfiguracji repozytoriów, weryfikacja połączenia i dopiero później korekta dostawcy, zakresu instalacji lub ustawień zabezpieczeń.

W jakich sytuacjach warto oddać urządzenie do diagnozy - Install-Module kończy się błędem

Pomoc serwisowa jest uzasadniona, gdy Install-Module nadal kończy się błędem po sprawdzeniu repozytorium, dostawcy NuGet i podstawowych ustawień połączenia. Szczególnie dotyczy to sytuacji, w której inne polecenia sieciowe działają, lecz PowerShell nie może pobierać pakietów, pojawiają się niejasne komunikaty o certyfikatach albo problem występuje jednocześnie przy kilku modułach. Wtedy potrzebna może być szersza analiza konfiguracji systemu, profilu użytkownika, zabezpieczeń połączenia i zgodności zainstalowanych składników.

Do serwisu warto zgłosić się także wtedy, gdy instalacja modułu jest potrzebna do pracy, a samodzielne zmiany mogłyby naruszyć działające skrypty lub konfigurację firmową. Przydatne będzie przekazanie pełnej treści komunikatu, nazwy modułu, używanej wersji PowerShell oraz informacji, czy polecenie uruchamiano w zwykłej konsoli, czy z podwyższonymi uprawnieniami. W Warszawskim Pogotowiu Komputerowym 24/7 wykonywana jest darmowa diagnoza laptopa, co pozwala najpierw ustalić źródło problemu, a dopiero później dobierać bezpieczne działania naprawcze.