WSH » wshshell » Run

Syntax:
WshShell.Run (strCommand [,intWindowStyle] [,bWaitOnReturn])
strCommand
Receives a string containing the command that will be run.
intWindowStyle
This optional parameter receives an integer corresponding to a window style in the Window Style Values table.
bWaitOnReturn
This optional parameter, when set to True, will cause the the script to suspend until the command finishes execution.

The Run method runs an application in a new process.

The Run method creates a new process and runs the command specified by strCommand. The optional parameter intWindowStyle is used to set the window style of the program being run. If the optional parameter bWaitOnReturn is set to True (default is False), then Run will return the return value returned by strCommand. Otherwise it returns 0. Also, if bWaitOnReturn is set to True, then the script will suspend its execution until strCommand finishes.

The following table shows the available settings for intWindowStyle.

Window Style Values

intWindowsStyle Settings
0 Hides the window and activates another window.
1 Activates and displays a window. If the window is minimized or maximized, the system restores it to its original size and position. An application should specify this flag when displaying the window for the first time.
2 Activates the window and displays it as a minimized window.
3 Activates the window and displays it as a maximized window.
4 Displays a window in its most recent size and position. The active window remains active.
5 Activates the window and displays it in its current size and position.
6 Minimizes the specified window and activates the next top-level window in the Z order.
7 Displays the window as a minimized window. The active window remains active.
8 Displays the window in its current state. The active window remains active.
9 Activates and displays the window. If the window is minimized or maximized, the system restores it to its original size and position. An application should specify this flag when restoring a minimized window.
10 Sets the show state based on the state of the program that started the application.

Examples

Code:
Set WshShell = WScript.CreateObject("WScript.Shell")
intReturn = WshShell.Run("notepad " & WScript.ScriptFullName, 1, TRUE)
WshShell.Popup "Notepad is now closed."
Explanation:

This VBScript code starts Notepad using the script's own full path name as the parameter for Notepad.

Language(s): VBScript