Microsoft KB Archive/328419

= How To Add and Remove Web Service Extension Files in IIS 6.0 =

Article ID: 328419

Article Last Modified on 12/3/2007

-

APPLIES TO


 * Microsoft Internet Information Services 6.0
 * Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)
 * 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 Add Web Service Extension Files
 * Add Web Service Extension Files on a Local Server
 * Add Web Service Extension Files on a Remote Server

Remove Web Service Extension Files
 * Remove Web Service Extension Files from a Local Server
 * Remove Web Service Extension Files from a Remote Server

Parameters REFERENCES



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

 *  : : 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 : 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 : 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 : 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

