Out-GridView niedostępne w PS 7

Out-GridView niedostępne w PowerShell 7 wskazuje na brak modułu Microsoft.PowerShell.GraphicalTools, wymaganego do wyświetlenia interaktywnej tabeli danych.

Na czym polega problem z Out-GridView w PowerShell 7

Komunikat „Out-GridView niedostępne w PS 7” oznacza, że polecenie służące do prezentowania wyników w interaktywnym oknie tabelarycznym nie jest dostępne w bieżącej instalacji PowerShell 7. Sam mechanizm filtrowania, sortowania i oglądania danych w osobnym oknie nie należy do podstawowego zestawu poleceń współczesnej, wieloplatformowej powłoki. W starszych środowiskach Windows PowerShell funkcja ta była kojarzona z dodatkowym komponentem graficznym, natomiast po przejściu do PowerShell 7 wymagane jest dołączenie odpowiedniego modułu.

Najczęściej chodzi o moduł Microsoft.PowerShell.GraphicalTools, który dostarcza polecenia przeznaczone do obsługi graficznego widoku danych. Jeżeli modułu nie zainstalowano, nie został zaimportowany albo jest uruchamiana wersja powłoki pozbawiona wymaganych składników, wpisanie Out-GridView może zakończyć się komunikatem o nierozpoznanym poleceniu. Nie musi to oznaczać uszkodzenia systemu ani błędu w samych danych przekazywanych do potoku.

Out-GridView przyjmuje obiekty wygenerowane przez inne polecenia PowerShell i przedstawia je w formie wygodnej do ręcznego przeglądania. Przykładowo wynik polecenia Get-Process, Get-Service albo własnego skryptu może zostać przekazany do widoku tabelarycznego za pomocą potoku. Brak tej funkcji wpływa więc przede wszystkim na sposób prezentacji wyników, a nie na samo działanie poleceń źródłowych.

Różnice między Windows PowerShell a PowerShell 7

Windows PowerShell 5.1 i PowerShell 7 są odrębnymi środowiskami, mimo że korzystają z podobnej składni i wielu wspólnych poleceń. Starsza wersja była silnie związana z platformą Windows oraz dostępnymi w niej komponentami graficznymi. PowerShell 7 został zaprojektowany jako nowsza powłoka działająca również poza Windows, dlatego część funkcji zależnych od interfejsu graficznego nie jest instalowana razem z głównym pakietem.

W praktyce oznacza to, że skrypt działający w Windows PowerShell może zachowywać się inaczej po uruchomieniu w PowerShell 7. Polecenia takie jak Get-Process | Out-GridView lub Get-Service | Out-GridView mogą wymagać dodatkowego modułu, nawet gdy sama składnia potoku jest poprawna. Należy również uwzględnić, czy używana sesja działa w systemie z dostępnym interfejsem graficznym. W środowisku bez pulpitu, podczas połączenia zdalnego albo w sesji uruchomionej z ograniczonym dostępem do okien rozwiązanie graficzne może być niepraktyczne lub niedostępne.

Podstawowym sposobem sprawdzenia sytuacji jest weryfikacja wersji powłoki oraz dostępności polecenia:

$PSVersionTable
Get-Command Out-GridView -ErrorAction SilentlyContinue
Get-Module -ListAvailable Microsoft.PowerShell.GraphicalTools

Jeżeli moduł znajduje się na komputerze, ale nie został załadowany automatycznie, można sprawdzić jego import i ponownie wyszukać polecenie. Gdy modułu brakuje, instalacja powinna być przeprowadzana z użyciem zaufanego źródła oraz z uwzględnieniem zasad obowiązujących na danym komputerze. Warto też sprawdzić, czy uruchomiono właściwą architekturę PowerShell i czy instalowany moduł odpowiada używanej wersji środowiska.

Out-GridView nie jest jedynym sposobem analizy wyników. W wielu skryptach można zastosować filtrowanie przez Where-Object, wybieranie kolumn za pomocą Select-Object, sortowanie poleceniem Sort-Object oraz zapis danych do pliku CSV przez Export-Csv. Takie rozwiązania są przydatne wtedy, gdy skrypt ma działać automatycznie, bez udziału użytkownika i bez otwierania dodatkowych okien.

Typowe przyczyny błędu i nieprawidłowej konfiguracji

Najczęstszą przyczyną jest po prostu brak modułu Microsoft.PowerShell.GraphicalTools. Może się tak zdarzyć po świeżej instalacji PowerShell 7, po migracji z Windows PowerShell albo po uruchomieniu skryptu na innym komputerze niż ten, na którym został przygotowany. Sam fakt, że w systemie dostępna jest wersja 5.1, nie oznacza automatycznie, że identyczne polecenie będzie dostępne w PowerShell 7.

Drugim źródłem problemów bywa nieprawidłowa ścieżka modułów. PowerShell wyszukuje moduły w określonych lokalizacjach zapisanych w zmiennej $env:PSModulePath. Jeżeli moduł został umieszczony w nietypowym katalogu, zainstalowany dla innego użytkownika albo zapisany w lokalizacji niewidocznej dla bieżącej sesji, polecenie może nadal być zgłaszane jako nieznane. Pomocne bywa sprawdzenie wartości tej zmiennej oraz ponowne uruchomienie powłoki po zakończeniu instalacji.

Występują również konflikty wersji. W systemie może znajdować się więcej niż jedna wersja modułu, a mechanizm rozwiązywania zależności może wybrać wariant niepasujący do aktualnego środowiska. Problem może pojawić się także wtedy, gdy instalacja została przerwana, pakiet jest uszkodzony albo polityka wykonywania skryptów ogranicza ładowanie niektórych składników. W takiej sytuacji warto przeanalizować dokładny tekst komunikatu, wynik Get-Module -ListAvailable oraz informacje zwracane przez Get-Command, zamiast wielokrotnie uruchamiać ten sam skrypt.

Osobną kwestią jest uruchamianie PowerShell 7 w środowisku, które nie udostępnia standardowego pulpitu. Out-GridView tworzy okno, dlatego brak sesji graficznej, ograniczenia aplikacji zdalnej lub praca w trybie tekstowym mogą uniemożliwić wykorzystanie tej funkcji nawet po poprawnym zainstalowaniu modułu. W zastosowaniach automatycznych bezpieczniej jest przygotować wynik w formacie tekstowym, CSV albo JSON. Pozwala to zachować działanie skryptu bez uzależniania go od obecności konkretnego interfejsu użytkownika.

Przy diagnozowaniu nie należy mylić kilku różnych komunikatów. „The term ... is not recognized” zwykle wskazuje na brak polecenia lub modułu w bieżącej sesji. Błąd dotyczący ładowania biblioteki może oznaczać niezgodność środowiska albo brak składnika systemowego. Z kolei komunikat o niemożności otwarcia okna może wskazywać na ograniczenia sesji graficznej, a nie na brak samego polecenia.

W jakich sytuacjach warto skorzystać z pomocy serwisu - Out-GridView niedostępne w PS 7

Zgłoszenie do serwisu jest uzasadnione, gdy Out-GridView przestało działać po aktualizacji systemu, zmianie wersji PowerShell, instalacji narzędzi administracyjnych albo przeniesieniu skryptów na inny komputer. W ramach sprawdzenia można ustalić, czy problem dotyczy tylko jednego użytkownika, całej instalacji PowerShell 7, ścieżek modułów, uprawnień lub środowiska graficznego. Pozwala to rozdzielić błąd konfiguracji od ewentualnych problemów z systemem operacyjnym.

Pomoc może być potrzebna również wtedy, gdy instalacja modułu kończy się błędem, polecenie działa w jednej konsoli, lecz nie działa w innej, albo skrypt wymaga dostosowania do pracy bez okna graficznego. Przed przekazaniem komputera warto zachować treść komunikatu, wersję PowerShell, używane polecenie oraz informację, czy problem występuje po ponownym uruchomieniu systemu. Takie dane ułatwiają odtworzenie sytuacji i ograniczają ryzyko przypadkowej zmiany konfiguracji.

W warszawskim serwisie laptopów i komputerów PC można zlecić sprawdzenie konfiguracji środowiska PowerShell, zależności modułów oraz ogólnego stanu systemu, a przy zgłoszeniu laptopa dostępna jest darmowa diagnoza LAPTOPA. Jeżeli okaże się, że przyczyna leży wyłącznie w konfiguracji użytkownika, możliwe jest uporządkowanie ścieżek modułów, instalacji i ustawień bez ingerowania w dane niezwiązane z problemem.

Po usunięciu przyczyny warto przetestować zarówno samo polecenie Out-GridView, jak i cały skrypt, który z niego korzysta. Należy sprawdzić działanie w zwykłej sesji oraz w scenariuszu, w którym skrypt ma być uruchamiany automatycznie. Jeżeli wymagane jest działanie na komputerach bez interfejsu graficznego, rozsądne może być zastąpienie widoku tabelarycznego eksportem danych lub filtrowaniem wykonywanym bezpośrednio w potoku.