How To Add and Remove Web Service Extension Files in IIS 6.0 (328419)


The information in this article applies to:

  • Microsoft Internet Information Services version 6.0
  • Microsoft Windows Server 2003, Datacenter Edition
  • Microsoft Windows Server 2003, Enterprise Edition
  • Microsoft Windows Server 2003, Standard Edition
  • Microsoft Windows Server 2003, Web Edition
  • Microsoft Windows Small Business Server 2003, Premium Edition
  • Microsoft Windows Small Business Server 2003, Standard Edition
This article was previously published under Q328419

IN THIS TASK

SUMMARY

This step-by-step article describes how to add Web service extension files such as Internet Server Application Programming Interface (ISAPI) extensions and Common Gateway Interface (CGI) applications to a local or a remote server in Internet Information Services (IIS) 6.0. The article also describes how to remove Web service extension files from a local or remote server in IIS 6.0.

The IIS 6.0 metabase contains the Web Service Extension Restriction List (WebSvcExtRestrictionList) property, which is a list of comma-separated strings that describe each Web service extension that is installed on the server and current state (enabled or disabled) of the extension. For IIS to use an extension, it must exist in the Web Service Extension Restriction List.

The Iisext.vbs command line script, which is stored in the Sysvol\system32\ (default Windows\System32) directory, can be used to add a single file to or remove a single file from the WebSvcExtRestrictionList property on a local or remote computer that is running IIS 6.0. The syntax for doing this is as follows:

Add Files:

IisExt /AddFile Drive:\Path\FileNameAccess {0|1} ID Deletable {0|1} ShortDesc [/s computer [/u [domain\]user/p password]]

Remove Files:

IisExt /RmFile Drive:\Path\FileName [/s Computer [/u [Domain\]User [/p Password]]]

For information about these parameters, see the Parameters section at the end of this article.

back to the top

Add Web Service Extension Files

This section describes how to add Web service extension files on a local server and a remote server.

back to the top

Add Web Service Extension Files on a Local Server

The following command adds the file Test.exe to the Web service extension restriction list (WebSvcExtRestrictionList) on the local server. In this example, the Access flag is set to 1 to enable the file on startup, the ID of the Web service extension is Test, and the Deletable flag is set to 0 to prevent the file from being deleted.

To add a Web service extension file, change to the Sysvol\System32 folder (the default is Windows\System32) at a command prompt, and then type the following command:

iisext /AddFile c:\Source\Test.exe 1 Test 0 Test

You receive the following response:
Connecting to server ...Done.
Adding extension file complete.
back to the top

Add Web Service Extension Files on a Remote Server

The following command adds the file Test.dll to the Web service extension restriction list (WebSvcExtRestrictionList) on the remote server. In this example, the Access flag is set to 0 to disable the file on startup, the ID of the Web service extension is Test, and the Deletable flag is set to 1 to allow the file to be deleted. The remote server name is Server1, the domain name is Domain1, and the username and password that are used to complete the task are Administrator:Password11. For more information about these parameters, see the Parameters section at the end of this article.

To add a Web service extension file, change to the Sysvol\System32 folder (the default is Windows\System32) at a command prompt, and then type the following command:

iisext /AddFile c:\Source\Test.dll 0 Test 1 Test /s Server1 /u Domain1\Administrator /p Password11

You receive the following response:
Connecting to server ...Done.
Adding extension file complete.
back to the top

Remove Web Service Extension Files

This section describes how to remove Web service extension files from a local server and a remote server.

back to the top

Remove Web Service Extension Files from a Local Server

The following command removes the file entry for Test.dll from the Web service extension restriction list (WebSvcExtRestrictionList) on a local server.

At a command prompt, change to the Sysvol\System32 folder (the default is Windows\System32), and then type the following command:

iisext /RmFile c:\Source\Test.dll

You receive the following response:
Connecting to server ...Done.
Removing extension file complete.
back to the top

Remove Web Service Extension Files from a Remote Server

The following command removes the file Test.exe from the Web service extension restriction list (WebSvcExtRestrictionList) on a remote computer. In this example, the remote server name is Server1, the domain name is Domain1, and the username and password that are used to complete the task are Administrator:Password11. For more information about these parameters, see the Parameters section at the end of this article.

At a command prompt, change to the Sysvol\System32 folder (the default is Windows\System32), and then type the following command:

iisext /RmFile c:\Source\Test.exe /s Server1 /u Domain1\Administrator /p Password11

You receive the following response:
Connecting to server ...Done.
Removing extension file complete.
back to the top

Parameters

  • Drive:\Path\FileName: This parameter specifies the file name and path of the Web service extension file to be added.
  • Access: The Access numeric designation is required because it designates whether a Web service extension file is disabled (0) or enabled (1) after the Web service is added.
  • ID: The ID is required when a Web server extension is added because it specifies the ID that is associated with the file. If the ID does not exist, Iisext creates it as the name of the file (that is, executable or DLL).
  • Deletable: The deletable numeric designation is required when a file is added because it can prevent (0) or allow (1) a Web service extension file from being deleted from the Web Service Extension Restriction List.
  • ShortDesc: This is the required short description of the Web service extension file.
  • /s Computer: This parameter specifies the network name or IP address of the remote computer. By default, if this parameter is not used, the script runs on the local computer.
  • /u Domain\User: This parameter specifies the user account that has administrative privileges on the remote computer and that will run the script. The script uses the locally logged on credentials if this option is not specified.
  • /p Password: This parameter specifies the password for the account that is used with the /u parameter. If the /s parameter is not used and a password is required, the user is prompted for the password, and the password is obscured.
  • /?: This parameter displays help at the command prompt.
back to the top

REFERENCES

For additional information, click the article numbers below to view the articles in the Microsoft Knowledge Base:

328360 How To Enable and Disable ISAPI Extensions and CGI Applications in IIS 6.0

328505 How To List Web Server Extensions and Extension Files in IIS 6.0

back to the top
Modification Type:MinorLast Reviewed:7/16/2004
Keywords:kbWebServices kbAppServices kbHOWTOmaster KB328419
©2004 Microsoft Corporation. All rights reserved.