Loading

Tuesday, October 13, 2009

Running 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.

No comments:

Post a Comment