Apply to: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1
A single file can be added to the WebSvcExtRestrictionList Metabase Property using a command line script (stored in systemroot\system32). This command can be executed on a local computer or a remote computer running a member of the Windows Server 2003 family with IIS 6.0. The Web Services Extension file can be an ISAPI extension or a CGI file.
Perform the same actions that can be used with the IIS Manager. You can use any tool to manage your IIS website.
Important matters
Only members of the Administrators group on the local computer can run scripts and executable files. As a security best practice, log on to the computer with an account that does not belong to the Administrators group, and then use the runas command to run the scripts and executables as administrator. At the command prompt, type runas /profile /User:MyComputer\Administrator cmd, use administrator permissions to open a command window, and then type (including the full path to the script and any parameters).
This topic includes the following information:
• Syntax: The order that must be taken when typing a command and any parameters and options that follow it.
• Parameters: Assign the value of the variable in the command.
•Example: Sample code and description of the results.
grammar
iisext /AddFile Drive:\Path\FileName Access {0|1} ID Deletable {0|1} ShortDesc[/s computer [/u [domain\]user/p password]]
parameter
Drive:\Path\FileName
Required. Specifies the file name and path of the Web service extension file to be added.
Access
Required. Use numbers to indicate whether the file is disabled (set to 0) or enabled (set to 1) after adding the file.
ID
Required. Specifies the ID of the Web Service Extension associated with the file.
Deletable
Required. Indicates whether a file can be deleted from the Web Services Extension Limit List by using iisext or IIS Manager. If set to 0, the file is deletion is prohibited; if set to 1, the file is deletion is allowed.
ShortDesc
Required. A brief description of the Web service extension associated with this file. This text can be localized and it should be the same as all files associated with the same Web service extension.
/s Computer
Run 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
Run the script with the permissions of the specified user account. The 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 for the user account specified in the /u parameter. If you ignore this parameter, the script prompts you for a password and does not display the typed text.
/?
Show help at the command prompt.
Example
Example 1:
The following command adds the file "" to the WebSvcExtRestrictionList property of the configuration database on the local computer. Set the Access flag to 0 to disable the file at startup, the ID flag identifies the associated Web Service Extension as "Payroll", and the Deletable flag to 1 to allow the file to be deleted from the Web Service Extension list.
iisext /AddFile c:\Source\ 0 Payroll 1 Payroll
In response, iisext displays the following:
Connecting to server …Done.
Adding extension file complete.
Example 2:
The following command adds the file "" to the WebSvcExtRestrictionList property of the configuration database on the remote computer. Set the Access flag to 1 to enable the file at startup, the ID flag identifies the associated Web Service Extension as "Payroll", and the Deletable flag to 0 to prohibit the file from being deleted from the Web Service Extension list.
iisext /AddFile c:\Source\ 1 Payroll 0 Payroll /s RemoteComputer /u Manager /p Pa$$Werd
In response, iisext displays the following:
Connecting to server ...Done.
Adding extension file complete.