Brak dostępu do galerii PowerShell

Brak dostępu do galerii PowerShell (PowerShell Gallery) przy instalacji modułów wskazuje na blokadę firewalla lub proxy firmowego uniemożliwiającego połączenie z repozytorium online.

Brak dostępu do galerii PowerShell – na czym polega problem

Brak dostępu do galerii PowerShell oznacza, że środowisko PowerShell nie może połączyć się z publicznym repozytorium PowerShell Gallery, z którego pobierane są moduły, skrypty i inne pakiety. Sam interpreter może uruchamiać się prawidłowo, a polecenia lokalne mogą działać bez zakłóceń, jednak próba użycia poleceń takich jak Install-Module, Find-Module lub Update-Module kończy się komunikatem o braku połączenia, przekroczeniu czasu oczekiwania albo niemożności odnalezienia źródła pakietów.

Nie musi to oznaczać uszkodzenia programu PowerShell. Problem może dotyczyć warstwy sieciowej, konfiguracji zabezpieczeń, certyfikatów, ustawień proxy albo sposobu, w jaki komputer rozpoznaje adres repozytorium. W praktyce należy odróżnić niedostępność samej galerii od błędu instalowanego modułu. Jeżeli strona repozytorium otwiera się w przeglądarce, nie ma jeszcze pewności, że PowerShell korzysta z tych samych ustawień połączenia i tych samych protokołów bezpieczeństwa.

Warto również sprawdzić, czy jako źródło pakietów zostało wskazane właściwe repozytorium. Polecenie Get-PSRepository pozwala odczytać zarejestrowane źródła, a Register-PSRepository może być potrzebne wtedy, gdy konfiguracja została usunięta albo zmieniona. Nie powinno się jednak bezrefleksyjnie nadpisywać istniejących ustawień, ponieważ może to ukryć przyczynę problemu i utrudnić późniejsze ustalenie, czy błąd wynikał z sieci, uprawnień, czy nieprawidłowego źródła.

Jak połączenie z PowerShell Gallery różni się od zwykłego dostępu do internetu

PowerShell Gallery jest usługą internetową, ale pobieranie modułu przebiega według określonego mechanizmu. PowerShell musi odnaleźć adres usługi, nawiązać bezpieczne połączenie, zweryfikować certyfikat, odczytać metadane pakietu, a następnie pobrać właściwe pliki. Każdy z tych etapów może zostać zatrzymany przez inną przeszkodę. Działająca poczta lub otwieranie popularnych stron nie potwierdza więc, że wszystkie wymagane połączenia dla galerii są możliwe.

Istotne znaczenie ma konfiguracja TLS, czyli protokołu używanego do szyfrowania transmisji. Starsza wersja środowiska albo nieaktualne składniki systemu mogą próbować korzystać z ustawień, których współczesna usługa już nie akceptuje. W takiej sytuacji pojawiają się komunikaty związane z kanałem zabezpieczonym, certyfikatem lub zamknięciem połączenia przez zdalny serwer. Pomocne może być ustalenie wersji PowerShell, wersji systemu oraz aktualności komponentów odpowiedzialnych za szyfrowanie, zamiast ograniczania diagnostyki do ponownego wpisywania polecenia instalacji.

Osobnego sprawdzenia wymaga serwer proxy. W sieci z pośrednikiem przeglądarka może mieć własną konfigurację, natomiast PowerShell może nie otrzymywać tych samych parametrów albo może wymagać uwierzytelnienia. Jeżeli połączenie przechodzi przez filtr treści, zapora może zezwalać na zwykłe przeglądanie, lecz blokować pobieranie pakietów lub zapytania do określonych punktów usługi. Przydatne jest porównanie wyników poleceń Test-NetConnection, Resolve-DnsName i Invoke-WebRequest, przy czym każdy test powinien być interpretowany z uwzględnieniem używanego adresu, portu i ustawień pośrednika.

Nie należy też pomijać problemów z rozwiązywaniem nazw. Błędny adres DNS, lokalny filtr bezpieczeństwa, wpis w pliku hosts albo chwilowa niedostępność dostawcy internetu mogą dawać podobny komunikat. Jeżeli dostęp jest niestabilny, warto wykonać test w różnych momentach i porównać zachowanie na innym łączu. Taka obserwacja pomaga rozstrzygnąć, czy przyczyna znajduje się w komputerze, w lokalnej sieci, czy poza nią.

Typowe błędy i objawy podczas instalowania modułów

Jednym z częstszych objawów jest komunikat informujący, że nie można odnaleźć modułu w żadnym z zarejestrowanych źródeł. Taki wynik może oznaczać rzeczywisty brak pakietu, ale równie dobrze może wynikać z niedostępności galerii. Przed uznaniem, że moduł został usunięty, należy sprawdzić, czy działa wyszukiwanie innych, znanych pakietów oraz czy źródło repozytorium ma status zaufanego i aktywnego.

Inna grupa błędów dotyczy braku uprawnień. Instalacja dla wszystkich użytkowników może wymagać uruchomienia konsoli z odpowiednim poziomem uprawnień, podczas gdy instalacja wyłącznie dla bieżącego użytkownika przebiega inną ścieżką. Zmiana uprawnień nie naprawi jednak blokady sieciowej. Jeżeli komunikat pojawia się jeszcze przed etapem zapisu plików, należy skupić się na połączeniu i uwierzytelnieniu, a nie na folderze docelowym.

Problematyczne bywają również pozostałości po nieudanych aktualizacjach. Częściowo pobrany moduł, niezgodna wersja zależności albo uszkodzony lokalny katalog pakietów może powodować błędy nawet wtedy, gdy sama galeria jest osiągalna. W takim przypadku pomocne jest odczytanie zainstalowanych wersji za pomocą Get-InstalledModule, sprawdzenie zależności i przeanalizowanie pełnego komunikatu błędu. Usuwanie katalogów modułów bez wcześniejszego ustalenia ich położenia może doprowadzić do utraty działającej wersji potrzebnej innym skryptom.

Warto zwrócić uwagę na różnicę między błędem certyfikatu a błędem polityki wykonywania skryptów. Certyfikat dotyczy zaufania do zabezpieczonego połączenia, natomiast polityka wykonywania decyduje, czy pobrany lub lokalny skrypt może zostać uruchomiony. Oba problemy mogą wystąpić podczas jednego zadania, lecz wymagają innych działań. Obniżanie poziomu zabezpieczeń bez rozpoznania przyczyny nie jest właściwą metodą diagnostyczną, szczególnie na komputerze używanym do pracy z poufnymi danymi.

Jeżeli pojawia się kod błędu, pełny tekst komunikatu należy zachować razem z użytym poleceniem, wersją PowerShell i informacją o tym, czy komputer korzysta z proxy. Skrócony opis w rodzaju „moduł się nie instaluje” zwykle nie wystarcza do rozróżnienia blokady sieciowej, problemu z TLS, błędu DNS, braku uprawnień i niezgodności wersji.

Kiedy warto skorzystać z pomocy serwisu - Brak dostępu do galerii PowerShell

Zgłoszenie do serwisu jest uzasadnione, gdy problem powtarza się po sprawdzeniu połączenia, źródła repozytorium i podstawowych ustawień PowerShell, a komunikat wskazuje na współdziałanie kilku warstw systemu. Dotyczy to szczególnie sytuacji, w której inne programy łączą się z internetem, lecz PowerShell nie może pobrać żadnego modułu, albo gdy błąd występuje po zmianie zabezpieczeń, aktualizacji systemu czy podłączeniu komputera do innej sieci.

W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić analizę takiego przypadku razem ze sprawdzeniem ustawień sieciowych, certyfikatów, konfiguracji proxy, repozytoriów i lokalnych składników PowerShell. Do zgłoszenia dobrze dołączyć dokładną treść komunikatu, nazwę modułu, wynik Get-PSRepository oraz informację, czy błąd pojawia się na jednym koncie, czy na wszystkich kontach użytkownika. Ułatwia to oddzielenie awarii środowiska od ograniczeń narzuconych przez sieć.

Przed przekazaniem komputera nie powinno się kasować historii poleceń ani usuwać całych katalogów modułów. Mogą one zawierać informacje potrzebne do odtworzenia kolejności zdarzeń. Nie należy także wyłączać zapory lub ochrony systemu na stałe tylko po to, aby sprawdzić, czy instalacja ruszy. Bezpieczniejsza jest kontrolowana diagnostyka, obejmująca pojedyncze testy, zapis wyników i przywrócenie ustawień po zakończeniu sprawdzania.

Po usunięciu przyczyny warto wykonać próbę wyszukania, instalacji i załadowania modułu, a następnie sprawdzić, czy działają także zależności wymagane przez używany skrypt. Dzięki temu można potwierdzić nie tylko dostęp do galerii, lecz także poprawność całego procesu od nawiązania połączenia do uruchomienia polecenia.