cscript
Komenda cscript
jest konsolową wersją Windows Script Host służącą do uruchamiania skryptów VBScript (.vbs), JScript (.js) oraz wsadowych (.) z poziomu wiersza poleceń. Zapewnia możliwość przekazywania parametrów do skryptów, obsługi przełączników sterujących środowiskiem skryptowym oraz wyświetlania komunikatów i wyników bez interfejsu graficznego.
- Host konsolowy: Domyślnie wyświetla wszystkie komunikaty w wierszu poleceń, zamiast w oknach dialogowych.
- Przełączniki: Umożliwia uruchamianie skryptu w różnych trybach (np. ciche, debug, wersja języka) przez użycie opcji rozpoczynających się od dwóch ukośników (
//
). - Przekazywanie parametrów: Parametry umieszczone po nazwie skryptu są przekazywane bezpośrednio do obsługi w kodzie skryptu.
Składnia
Dział zatytułowany „Składnia”cscript [//B] [//D] [//E:engine] [//H:CScript|WScript] [//Job:jobname] [//Logo] [//NoLogo] [//S] [//T:nn] [//U] [//X] scriptname [param1 [param2 [...]]]
Parametry
Dział zatytułowany „Parametry”Przełącznik | Opis |
---|---|
//B | Tryb cichy – wycisza wszystkie komunikaty błędów. |
//D | Włącza debugging skryptu przy starcie. |
//E:engine | Określa silnik skryptowy (np. VBScript, JScript). |
//H:CScript | Ustawia cscript jako domyślnego hosta skryptów. |
//H:WScript | Ustawia wscript jako domyślnego hosta skryptów. |
//Job:jobname | Uruchamia zadanie zdefiniowane w Rejestrze zadań (skrót do schtasks ). |
//Logo | Wyświetla baner Windows Script Host przed uruchomieniem skryptu (domyślnie włączone). |
//NoLogo | Wyłącza wyświetlanie banera Windows Script Host. |
//S | Zachowuje w rejestrze bieżące ustawienia (m.in. przypisanie hosta skryptu). |
//T:nn | Ustawia limit czasu wykonania skryptu w sekundach (gdzie nn to liczba). |
//U | Wyświetla wyniki w Unicode. |
//X | Uruchamia skrypt w trybie debuggera. |
Przykłady użycia
Dział zatytułowany „Przykłady użycia”1. Uruchomienie skryptu VBScript
Dział zatytułowany „1. Uruchomienie skryptu VBScript”cscript //NoLogo C:\Scripts\Backup.vbs
Wykonuje skrypt bez wyświetlania banera hosta.
2. Uruchomienie w trybie debug
Dział zatytułowany „2. Uruchomienie w trybie debug”cscript //X //D C:\Scripts\Analyze.js param1 param2
Uruchamia skrypt JavaScript w konsoli z debugerem i przekazuje dwa parametry.
3. Zmiana domyślnego hosta
Dział zatytułowany „3. Zmiana domyślnego hosta”cscript //H:WScript
Ustawia graficzny host skryptów jako domyślny (powrót do wscript).
- W przypadku skryptów generujących interfejsy GUI należy używać
wscript
, aby nie potęgować błędów związanych z brakiem okien dialogowych w konsoli. - Parametry przekazywane do skryptu są dostępne w kolekcji
WScript.Arguments
. - Użycie
//NoLogo
jest zalecane w skryptach automatyzacji i zadaniach planowanych, by uniknąć dodatkowego tekstu w logach.
Najczęściej spotykane błędy i rozwiązania
Dział zatytułowany „Najczęściej spotykane błędy i rozwiązania”Błąd | Przyczyna | Rozwiązanie |
---|---|---|
‘cscript’ is not recognized | Ścieżka do WSH nie jest w zmiennej PATH | Sprawdź instalację Windows Script Host lub zmodyfikuj zmienną PATH. |
Syntax error | Błąd składni w skrypcie | Sprawdź kod skryptu, popraw błędy składniowe i ponów uruchomienie. |
Access is denied | Brak uprawnień do pliku lub folderu | Uruchom wiersz poleceń jako administrator lub dostosuj uprawnienia. |
Timeout expired | Przekroczono limit czasu ustawiony //T: | Zwiększ wartość limitu lub usuń przełącznik //T: . |