To run scripts using the command-line-based script host (Cscript.exe)
You can run scripts with the command-line-based script host by typing the following at the command prompt:
cscript [script name] [host options] [script arguments]
Where:
-
script name is the name of the script file, including the file name extension and any necessary path information.
-
host options are the command-line switches that enable or disable various Windows Script Host features. Host options are always preceded by two slashes (//).
-
script arguments are the command-line switches that are passed to the script. Script arguments are always preceded by one slash (/).
Note
-
Each parameter is optional; however, you cannot specify script arguments without specifying a script. If you do not specify a script or any script arguments, Cscript.exe displays the Cscript.exe syntax and the valid host options.
-
The command-line-based script host supports the following host options:
Parameter
Action
//B
Specifies batch mode, which does not display alerts, scripting errors, or input prompts.
//D
Turns on the debugger.
//E: engine
Specifies the scripting language that is used to run the script.
//H:cscript or //H:wscript
Registers either Cscript.exe or Wscript.exe as the default script host for running scripts. If neither is specified, the default is Wscript.exe.
//I
Specifies interactive mode, which displays alerts, scripting errors, and input prompts. This is the default and the opposite of //B.
//Job: xxxx
Runs the job identified by xxxx in a .wsf script file.
//Logo
Specifies that the Windows Script Host banner is displayed in the console window before the script runs. This is the default and the opposite of //Nologo.
//Nologo
Specifies that the Windows Script Host banner is not displayed before the script runs.
//S
Saves the current command-prompt options for the current user.
//T: nnnnn
Specifies the maximum time the script can run (in seconds). You can specify up to 32,767 seconds. The default is no time limit.
//X
Starts the script in the debugger.
//?
Displays available command parameters and provides help for using them (this is the same as typing Cscript.exe with no parameters and no script).
-
The time out option (//T:nnnnn) prevents excessive execution of scripts by setting a time limit. When execution time exceeds the specified value, Cscript.exe interrupts the script engine and stops the process.
-
You can also use Windows Script Host to create .wsf script files, with which you can call multiple scripting engines and perform multiple jobs, all from one file.
Related Topics
- Using the command-based script host (CScript.exe)
- Download Windows Script Host samples
- Windows Script Host object model
- Windows Script Host overview
- Run scripts using the command-line-based script host (cscript.exe)
- Run scripts using the Windows-based script host (Wscript.exe)
- Run Windows Script Host samples
- Set global properties for all scripts that are run with the Windows-based script host (Wscript.exe)
- Set properties for individual scripts that are run with the Windows-based script host (Wscript.exe)
-
For more information, see the Windows Script Technologies Web site at the Microsoft Web site.
