Share via


Enabling Web Service Extension Files

You can use the command-line script iisext.vbs, which is stored in systemroot\system32, to enable a single file that is in the WebSvcExtRestrictionList property of the metabase. The command can be executed on any local or remote computer running Windows.NET with IIS6.0. Web service extension files can be either ISAPI extensions or CGI files.

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

important Important You must be a member of the Administrators group on the local computer to run scripts and executables, or you must have been delegated the appropriate authority. As a security best practice, log on to your computer 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. From the command prompt, type runas /user:administrative_accountname "script or executable command".

This topic contains the following sections:

  • 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/EnFile Drive:\Path\FileName [/scomputer [/u [domain\]user**/p** password]]

Parameters

  • Drive:\Path\FileName
    Required. Specifies the file name and the path of the Web service extension file that is going to be enabled.
  • /sComputer
    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.
  • /pPassword
    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.

Example 1: Enabling a Web service extension file on a local computer

The following command enables the file "Timesheet.exe" in the WebSvcExtRestrictionList property of the metabase on the local computer:

iisext /EnFile c:\Source\Timesheet.exe

In response, iisext displays the following:

Connecting to server ...Done.
Enabling extension file complete.

Example 2: Enabling a Web service extension file on a remote computer

The following command enables the file "Taxes.dll" in the WebSvcExtRestrictionList property of the metabase on a remote computer:

iisext /EnFile c:\Source\Taxes.dll /s RemoteComputer /u Manager /p Pa$$Werd

In response, iisext displays the following:

Connecting to server ...Done.
Enabling extension file complete.