Windows Script Host object model

The Windows Script Host object model gives you a logical, systematic way to perform many administrative tasks. The set of COM interfaces that it provides has two main categories.

Script execution and troubleshooting

Properties and methods directly related to script execution. This set of interfaces allows scripts to perform basic manipulation of the Windows Script Host, display messages on the screen, and perform basic COM functions such as CreateObject and GetObject.

Helper functions

Properties and methods for performing actions such as mapping network drives, connecting to printers, retrieving and modifying environment variables, and manipulating registry keys. Administrators can also use the Windows Script Host helper functions to create simple logon scripts


What you can do with this object


Set and retrieve command-line arguments

Determine the name of the script file

Determine the host file name (Wscript.exe or Cscript.exe)

Determine the host version information

Create, connect to, and disconnect from COM objects

Sink events

Stop the execution of a script programmatically

Send information to the default output device (either a dialog box or the console)


Access the entire set of command-line arguments


Access the set of named command-line arguments


Access the set of unnamed command-line arguments


Connect to and disconnect from network shares and network printers

Map to and disconnect from network shares

Access information about the user who is currently logged on


Create a remote script process using the Controller method CreateScript() 


Remotely administer computer systems on a computer network

Programmatically manipulate other programs and scripts

WshRemote Error

Access the error information that is available when a remote script (a WshRemote object) terminates as a result of a script error


Run a program locally

Manipulate the contents of the registry

Create a shortcut

Access a system folder

Manipulate environment variables, such as WINDIR, PATH, or PROMPT


Programmatically create a shortcut


Access any of the Windows special folders


Programmatically create a shortcut to an Internet resource


Access any of the environment variables, such as WINDIR, PATH, or PROMPT


Determine status and error information about a script that is run with Exec() 

Access the stdIn, stdOut, and stdErr channels

In addition to the object interfaces provided by Windows Script Host, administrators can use any ActiveX control, that exposes automation interfaces, to perform various tasks on the Windows platform. For example, administrators can write scripts to manage the Active Directory directory services.

For more information, see the Windows Script Technologies Web site at the Microsoft Web site.

Set properties for individual scripts that are run with the Windows-based script host (Wscript.exe)

Set global properties for all scripts that are run with the Windows-based script host (Wscript.exe)

Run Windows Script Host samples

Run scripts using the Windows-based script host (Wscript.exe)

Run scripts using the command-line-based script host (cscript.exe)

Windows Script Host overview

Windows Script Host object model

Download Windows Script Host samples

© 2017 Microsoft Corporation. All rights reserved. Contact Us |Terms of Use |Trademarks |Privacy & Cookies