chgusr
Komenda chgusr
to wierszowe narzędzie dostępne na serwerach z rolą Remote Desktop Session Host, służące do zmiany trybu instalacji aplikacji na serwerze terminali między install mode a execute mode. W odróżnieniu od nowszego change user
, chgusr
jest dostarczane w starszych środowiskach Windows Server w celu utrzymania kompatybilności wstecznej. Po wywołaniu bez parametrów lub z nieprawidłowym przełącznikiem wyświetla instrukcję użycia z listą dostępnych opcji.
Składnia
Dział zatytułowany „Składnia”chgusr {/EXECUTE | /INSTALL | /QUERY}
/EXECUTE
– przełącza serwer z trybu instalacji z powrotem do execute mode (domyślnie)./INSTALL
– ustawia serwer w install mode, co pozwala poprawnie zarejestrować wpisy w rejestrze i plikach INI podczas instalacji aplikacji./QUERY
– wyświetla bieżący stan trybu (INSTALL lub EXECUTE).
Parametry
Dział zatytułowany „Parametry”Przełącznik | Opis |
---|---|
/EXECUTE | Powrót do normalnego trybu wykonywania aplikacji (domyślny). |
/INSTALL | Przełączenie do trybu instalacyjnego, wymagane podczas instalacji większości aplikacji. |
/QUERY | Wyświetla aktualny tryb pracy serwera – INSTALL lub EXECUTE. |
Przykłady użycia
Dział zatytułowany „Przykłady użycia”-
Sprawdzenie bieżącego trybu
Okno terminala chgusr /QUERYWyświetla np.:
Current install mode: EXECUTE
. -
Przełączenie w tryb instalacji
Okno terminala chgusr /INSTALLUstawia serwer w trybie instalacyjnym, wymaganym przez instalatory.
-
Powrót do trybu wykonywania
Okno terminala chgusr /EXECUTEPrzywraca domyślny tryb wykonywania aplikacji po instalacji.
chgusr
jest aliasem dochange user
; obie komendy wykonują identyczne operacje, ale w nowszych wersjach rekomendowane jestchange user
.- Narzędzie działa tylko w sesji CMD.exe na serwerze z rolą RD Session Host; w przeciwnym razie zwróci błąd nierozpoznania polecenia.
- Wymagane są uprawnienia administratora; bez nich pojawi się komunikat
Access is denied
. - Dostępne w Windows NT 4.0 Terminal Server Edition oraz we wszystkich kolejnych wersjach Windows Server i klientach z rolą RD Session Host.
- W migracjach do nowszych środowisk warto zastąpić
chgusr
komendąchange user
dla spójności.
Najczęściej spotykane błędy i ich rozwiązania
Dział zatytułowany „Najczęściej spotykane błędy i ich rozwiązania”Błąd i komunikat | Przyczyna | Rozwiązanie |
---|---|---|
’chgusr’ is not recognized as an internal or external command | Brak roli RD Session Host lub uruchomienie w PowerShell bez ścieżki do CMD. | Uruchom Command Prompt na serwerze z rolą RD Session Host; sprawdź, czy %SystemRoot%\System32 jest w PATH. |
Access is denied. | Brak uprawnień administratora. | Uruchom CMD jako administrator (prawy przycisk → „Uruchom jako administrator”). |
Invalid parameter: ‘/xyz’ | Literówka lub nieistniejący przełącznik. | Sprawdź składnię (/EXECUTE , /INSTALL , /QUERY ) i użyj chgusr /? , aby wyświetlić dostępne opcje. |
Unexpected output or no mode change | Wykonanie polecenia w sesji zdalnej niespełniającej warunków konsolowych. | Upewnij się, że wywołujesz chgusr w konsoli serwera (fizycznej lub przez iLO/DRAC), a nie przez RDP. |
Installation mode persists po restarcie | Użyto /INSTALL bez późniejszego /EXECUTE ; tryb instalacyjny pozostał aktywny. | Po zakończeniu instalacji zawsze wróć do trybu wykonywania za pomocą chgusr /EXECUTE . |
Porada: W skryptach sprawdzaj stan trybu przed i po zmianie za pomocą
/QUERY
, aby uniknąć przypadkowych przełączeń.