ASP. net iis registration tool (aspnet_regiis.exe)

When multiple. NET Framework versions are concurrently executed on a computer, they are mapped to ASP. NET applications.ProgramThe ASP. net isapi version determines the version of the Common Language Runtime library used by the application. ASP. net iis registration tool (aspnet_regiis.exe) Allows administrators or installers to conveniently update script ing of ASP. NET applications so that they point to the ASP. net isapi version associated with the tool. The tool can also be used to display the status of all installed ASP. NET versions, register ASP. NET versions coupled with the tool, create client script directories, and perform other configuration operations.

Aspnet_regiis [Options]

You can specify one or more options.

Option description

-C install ASP. NET client scripts (such as client verification scripts) in the aspnet_client subdirectory of each IIS Site Directory.

Note that only ASP. NET client scripts associated with aspnet_regiis.exe are installed.

-E remove ASP. NET client scripts from the aspnet_client subdirectory of each IIS Site Directory.

Note that only ASP. NET client scripts associated with aspnet_regiis.exe are removed.

-Ea removes all ASP. NET client scripts from the aspnet_client subdirectory of each IIS Site Directory.

-I install the ASP. NET version associated with aspnet_regiis.exe, and update the script ing between the IIS metadata library root directory and the root directory.

Note that only the script ing of applications that use earlier ASP. NET versions is updated. New applications are not affected.

-IR installs the ASP. Net version associated with aspnet_regiis.exe and only registers ASP. NET in IIS.

Note that this option does not update the script ing. To install ASP. NET and update script ing, use the-I option.

-K path removes all ASP. Net version script mappings from all ASP. NET applications in the specified application root path and Its subdirectories.

-Kn path only removes all ASP. NET version script mappings from the ASP. NET application in the specified application root path.

Note that this option does not affect applications in the path subdirectory.

-LK: lists the paths and versions of all IIS metadatabase items mapped by ASP. NET scripts.

Note that the ing of ASP. NET scripts inherited from the parent item is not displayed.

-LV: lists the status and installation path of all ASP. NET versions installed on the computer.

-R updates the ing of all scripts in and below the IIS metadatabase to point to the ASP. net isapi version associated with aspnet_regiis.exe.

Note that all existing script mappings are updated to point to the ASP. net isapi version associated with aspnet_regiis.exe (not related to the current version ).

-S path maps scripts pointing to ASP. net isapi versions associated with aspnet_regiis.exe to all ASP. NET applications in the specified application root path and Its subdirectories. Update all existing script ing using the earlier ASP. net isapi version in the specified path and below.

-The Sn path maps the script pointing to the ASP. net isapi version associated with aspnet_regiis.exe to the ASP. NET application under the specified application root path. Update all existing script mappings using earlier ASP. net isapi versions in the specified path.

Note that this option does not affect applications in the path subdirectory.

-U uninstalls the ASP. NET version associated with aspnet_regiis.exe from the computer. The current script ing of this ASP. net isapi version is automatically remapped to the highest version of other installed ASP. net isapi versions.

-UA uninstalls all ASP. NET versions from the computer.

-? Displays the command syntax and options of this tool.

Remarks

When multiple ASP. NET versions are installed on a computer, ASP. NET runs concurrently. During installation, Internet Information Service (IIS) needs to know which ASP. net isapi (aspnet_isapi.dll) version should process pages in ASP. NET applications. The version of the ASP. net isapi associated with the ASP. NET application determines the version of the Common Language Runtime library used by the application. In IIS, ASP. NET applications are associated with ASP. net isapi versions through script ing. To simplify the configuration process of ASP. NET applications, each ASP. NET version has a linked aspnet_regiis.exe version.

Note that each. NET Framework version has a unique aspnet_regiis.exe version. Since each version of the tool only applies to the. NET Framework Version associated with it, you must use the correct version of the tool to configure ASP. NET applications.

Aspnet_regiis.exe is usually used with the-S or-Sn option to remap ASP. NET applications to the. NET Framework Version associated with the tool. Use the-s option to update the application in the specified root path and all its subdirectories. If you do not want to update the application in the subdirectory, use the-Sn option. To update the script ing of all existing ASP. NET applications on the computer at the same time, use the-r option.

Note that the path parameter references the root path of the application, rather than the physical path. For example, w3svc/1/root/sampleapp1.

Instead, you can use the-K or-kn option to remove any ASP. Net version script ing from the application by specifying the root path of the application.

Note: If the specified root path inherits its script ing from the parent root path, the-K and-kn options are invalid.

This tool can also be used to install and uninstall the ASP. NET version of the link. Use the-I option to install ASP. NET and update script ing for all existing ASP. NET applications. Use the-IR option to install ASP. NET without updating the script ing. To uninstall the ASP. NET version associated with the tool, use the-u option. To uninstall all ASP. NET versions from your computer, use the-UA option.

You can use aspnet_regiis.exe to view ASP. NET information. To list the status and installation path of all installed ASP. NET versions, use the-LV option. To view the paths of all IIS metadatabase items mapped to ASP. NET, use the-LK option.

You can use aspnet_regiis.exe to install and remove client scripts, such as client verification. To install the ASP. NET client script associated with this tool to the aspnet_client subdirectory of each IIS Site Directory, use the-C option. To remove only the ASP. NET client scripts associated with the tool, use the-e option. To remove all installed ASP. NET client scripts, use the-ea option.

For more information about parallel execution in ASP. NET, see side-by-side support in ASP. NET. For more information about script ing and application root path, see IIS documentation (http: // localhost/IISHelp ). Note: You must install IIs before you can view the IIS documentation.

Example

The following command maps the ASP. NET script associated with aspnet_regiis.exe to the sampleapp1 application and all its subapplications.

Aspnet_regiis-s w3svc/1/root/sampleapp1

The following command only updates the script ing of the sampleapp1 application without affecting the application in the subdirectory.

Aspnet_regiis-Sn w3svc/1/root/sampleapp1

The following command installs the ASP. Net version associated with the tool and updates the script ing of all existing ASP. NET applications. Note: Only applications mapped to earlier ASP. NET versions are affected.

Aspnet_regiis-I

The following command installs the ASP. NET version associated with the tool, but does not update the script ing of the existing ASP. NET application.

Aspnet_regiis-IR

The following command displays the status and installation path of all ASP. NET versions installed on the computer.

Aspnet_regiis-LV