Nie działa WindowsCompatibility

Niedziałający moduł WindowsCompatibility w PowerShell wskazuje na brak zainstalowanego modułu kompatybilności umożliwiającego użycie cmdletów Windows PowerShell w PowerShell 7.

Nie działa WindowsCompatibility – co oznacza ten problem

Komunikat „Nie działa WindowsCompatibility” odnosi się zwykle do sytuacji, w której w programie PowerShell 7 nie można załadować modułu WindowsCompatibility albo nie udaje się uruchomić poleceń przeznaczonych pierwotnie dla klasycznego Windows PowerShell. Moduł ten został przygotowany jako warstwa zgodności: pozwala korzystać z wybranych starszych modułów i cmdletów, które nie zostały jeszcze przystosowane do nowoczesnego środowiska PowerShell.

Nie jest to zazwyczaj awaria samego systemu Windows. Przyczyną może być brak modułu, nieprawidłowa instalacja, ograniczenie zasad wykonywania skryptów, uruchomienie niewłaściwej wersji PowerShell albo próba użycia polecenia, którego moduł nie potrafi przekazać do starszego środowiska. Znaczenie ma również sposób zainstalowania PowerShell, ponieważ PowerShell 7 i Windows PowerShell 5.1 są odrębnymi aplikacjami i mogą działać równolegle.

Kontekst techniczny i sposób działania modułu

PowerShell 7 korzysta z nowszej platformy uruchomieniowej i własnego zestawu modułów. Windows PowerShell 5.1 jest natomiast starszym środowiskiem obecnym w systemach Windows i zawiera wiele narzędzi zaprojektowanych jeszcze przed pojawieniem się PowerShell 7. Nie wszystkie moduły systemowe mogą być bezpośrednio załadowane w obu wersjach. WindowsCompatibility próbuje rozwiązać ten problem przez przekazanie wybranych operacji do procesu Windows PowerShell, a następnie udostępnienie ich wyników w bieżącej sesji.

W praktyce nie oznacza to pełnej zgodności każdego polecenia. Moduły wykorzystujące określone elementy graficznego interfejsu, zależności dostępne wyłącznie w starszym środowisku lub nietypowy sposób komunikacji z systemem mogą działać częściowo albo wcale. Ograniczenia mogą być widoczne jako błąd importowania modułu, brak polecenia po wykonaniu Import-Module, zawieszenie sesji lub komunikat o braku wymaganej wersji środowiska.

Przy analizie problemu należy najpierw ustalić, z którego PowerShell korzysta dana konsola. Pomocne bywają polecenia $PSVersionTable, Get-Module -ListAvailable oraz Get-Command. Pozwalają sprawdzić wersję powłoki, dostępność modułu i to, czy oczekiwane polecenie jest faktycznie widoczne w bieżącym środowisku. Ważne jest także rozróżnienie między modułem zainstalowanym dla konkretnego użytkownika a modułem dostępnym dla wszystkich użytkowników komputera.

Typowe problemy i błędy związane z WindowsCompatibility

Jednym z częstszych przypadków jest próba użycia polecenia WindowsCompatibility jako samodzielnego cmdletu. Nazwa ta oznacza moduł, a nie pojedynczą funkcję wykonującą naprawę. Jeżeli moduł nie został zainstalowany lub nie został zaimportowany, system może zgłosić, że nie rozpoznaje nazwy polecenia albo nie znajduje wskazanego modułu.

Problemy mogą również wynikać z instalacji modułu w lokalizacji, której bieżąca sesja nie przeszukuje. Wtedy warto zweryfikować ścieżki zapisane w zmiennej $env:PSModulePath oraz sprawdzić, czy moduł znajduje się w jednym z tych katalogów. Nieprawidłowa składnia polecenia, literówka w nazwie, uruchomienie PowerShell bez odpowiednich uprawnień i konflikt kilku wersji tego samego modułu także mogą powodować mylące komunikaty.

Osobną grupę stanowią ograniczenia bezpieczeństwa. Zasady wykonywania skryptów mogą blokować część operacji, a zabezpieczenia systemu mogą uniemożliwiać uruchomienie plików pobranych z internetu. Nie powinno się jednak zmieniać tych ustawień bez sprawdzenia ich zakresu, ponieważ zbyt szeroka zmiana może obniżyć ochronę komputera. Najpierw należy odczytać bieżącą konfigurację, ustalić, która reguła powoduje błąd, i zastosować możliwie wąskie rozwiązanie.

Warto pamiętać, że nie każdy błąd modułu oznacza konieczność jego ponownej instalacji. Czasem przyczyną jest niezgodność konkretnego cmdletu, brak właściwego składnika systemu, uszkodzona sesja PowerShell albo wywołanie polecenia w niewłaściwym kontekście. Pomocne może być uruchomienie nowej sesji, sprawdzenie pełnej treści błędu, użycie Get-Error oraz porównanie zachowania polecenia w PowerShell 7 i Windows PowerShell 5.1.

Kiedy najlepiej poprosić o ocenę stanu sprzętu - Nie działa WindowsCompatibility

Zgłoszenie do serwisu jest uzasadnione wtedy, gdy błąd WindowsCompatibility powtarza się mimo sprawdzenia wersji PowerShell, dostępności modułu i podstawowych uprawnień, a wykonywane zadanie jest potrzebne do pracy lub administracji komputerem. Szczególnej uwagi wymagają sytuacje, w których razem z problemem pojawiają się błędy usług systemowych, uszkodzone profile użytkowników, nieudane aktualizacje, samoczynne zamykanie konsoli albo problemy z uruchamianiem innych narzędzi Windows.

Przed przekazaniem urządzenia dobrze zachować dokładną treść komunikatu, nazwę wykonywanego polecenia, wersję PowerShell oraz informację, czy problem występuje na jednym koncie, czy na wszystkich kontach użytkowników. Takie dane ułatwiają odtworzenie sytuacji i ograniczają ryzyko przypadkowej zmiany konfiguracji. Nie zaleca się kopiowania do internetu całych logów zawierających nazwy użytkowników, ścieżki prywatnych katalogów lub dane firmowe.

W Warszawie pomoc przy tego typu usterkach można zgłosić do Warszawskiego Pogotowia Komputerowego 24/7, gdzie przed rozpoczęciem właściwych prac wykonywana jest darmowa diagnoza LAPTOPA. Dzięki temu można rozdzielić problem dotyczący samego PowerShell od szerszej usterki systemu Windows, uszkodzenia profilu lub błędnej konfiguracji komputera.