Adding Application Dependencies Using Iisext.vbs

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1

You can use the command-line script iisext.vbs, which is stored in systemroot\system32, to add dependencies between applications and one or more Web service extensions on computers running a member of the Windows Server 2003 family with IIS 6.0. If the application does not exist in the ApplicationDependencies Metabase Property, iisext will create it.

Iisext.vbs performs the same operations that are available in IIS Manager. You can use either tool to administer IIS Web sites.

Important

You must be a member of the Administrators group on the local computer to run scripts and executables. As a security best practice, log on to your computer by using an account that is not in the Administrators group, and then use the runas command to run your script or executable as an administrator. At a command prompt, type runas /profile /User:MyComputer\Administrator cmd to open a command window with administrator rights and then type cscript.exe ScriptName (include the script's full path and any parameters).

This topic includes the following information:

  • Syntax: The order in which you must type a command and any arguments and options that follow it.

  • Parameters: The values that are given to variables in the command.

  • Examples: Sample code and an explanation of the results.

Syntax

iisext /AddDep Application ID [ID] [/s Computer [/u [Domain\]User [/p Password]]]

Parameters

Application

Required. Specifies the name of the application that is dependent on a Web service extension.

ID

Required. Specifies the ID of the Web service extension upon which the application is dependent. Additional dependencies are optional.

/s Computer

Runs the script on the specified remote computer. Type the computer name or IP address without backslashes. By default, the script runs on the local computer.

/u [Domain\]User

Runs the script with the permissions of the specified user account. This account must be a member of the Administrators group on the remote computer. By default, the script runs with the permissions of the current user of the local computer.

/p Password

Specifies the password of the user account that is specified in the /u parameter. If you omit this parameter, the script prompts you for the password and obscures the text you type.

Examples

Example 1:

The following command makes the application "Payroll" dependent on the Web service extension "timesheet" on the local computer. In this example, the files that are required for the Web service extension "timesheet" were previously added to and enabled on the local computer.

iisext /AddDep Payroll timesheet

In response, iisext displays the following:

Connecting to server ...Done.

Adding dependency complete.

Example 2:

The following command makes the application "TravelPlans" dependent on the Web service extensions "FlightSchedules" and "HotelRooms" on a remote computer. In this example, the files that are required for the Web service extensions "FlightSchedules" and "HotelRooms" were previously added to and enabled on the remote computer.

iisext /AddDep TravelPlans FlightSchedules HotelRooms /s RemoteComputer /u Manager /p Pa$$Werd

In response, iisext displays the following:

Connecting to server ...Done.

Adding dependency complete.