asp.net IIS registration tool (Aspnet

Asp.net|iis when multiple. NET Framework versions are executed in parallel on a single computer, the ASP.net ISAPI version that is mapped to the ASP.net application determines the version of the common language runtime that is used by the application. The ASP.net IIS registration tool (Aspnet_regiis.exe) makes it easy for an administrator or installer to update script mappings for ASP.net applications to point to the ASP.net ISAPI version associated with the tool. The tool can also be used to show the status of all installed ASP.net versions, register asp.net versions that are coupled to the tool, create client script directories, and perform other configuration actions.
aspnet_regiis [Options]
You can specify one or more of the following options.

Options description
-C Installs asp.net client script (such as client-side validation scripts) into the aspnet_client subdirectory of each IIS site directory.
Note Install only the ASP.net version of the client script associated with the aspnet_regiis.exe.
-e removes asp.net client script from the aspnet_client subdirectory of each IIS site directory.
Note Only the ASP.net version of the client script that is associated with aspnet_regiis.exe is removed.
-ea removes all asp.net versions of client script from the aspnet_client subdirectory of each IIS site directory.
-I installs the ASP.net version associated with aspnet_regiis.exe and updates the script mappings under the IIS metabase root and root directory.
Note Only the script mappings for applications that use the earlier ASP.net version are updated. Using the new version of the application is not affected.
-ir installs the ASP.net version associated with aspnet_regiis.exe and registers asp.net only in IIS.
Note This option does not update script mappings. To install ASP.net and update your script mappings, use the-i option.
-K path removes all asp.net version of the script mappings from all asp.net applications in the specified application root path and its subdirectories.
-KN path removes all asp.net versions of the script map from the ASP.net application only in the specified application root path.
Note This option does not affect applications in the path subdirectory.
-LK lists the paths and versions of all IIS metabase entries that contain ASP.net script mappings.
Note the items that inherit asp.net script mappings from the parent are not displayed.
-LV lists the status and installation path for all ASP.net versions installed on the computer.
-R updates all script mappings in the IIS metabase and below to point to the ASP.net ISAPI version associated with Aspnet_regiis.exe.
Note All existing script mappings are updated to point to the ASP.net ISAPI version associated with the Aspnet_regiis.exe (regardless of the current version).
-S path installs the script map that points to the ASP.net ISAPI version associated with aspnet_regiis.exe to all asp.net applications in the specified application root path and its subdirectories. Updates all existing script mappings in the specified path and below using the earlier ASP.net ISAPI version.
-SN Path installs the script map that points to the ASP.net ISAPI version associated with aspnet_regiis.exe to the ASP.net application under the specified application root path. Updates all existing script mappings in the specified path that use the earlier ASP.net ISAPI version.
Note 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 existing script mappings for this asp.net ISAPI version are automatically remap to the highest version of the remaining installed ASP.net ISAPI versions.
-ua Uninstall all ASP.net versions from the computer.
-? Displays the command syntax and options for this tool.

Note
When multiple versions of ASP.net are installed on a single computer, it is said that ASP.net is running in parallel. In this installation, Internet Information Services (IIS) needs to know which asp.net ISAPI (aspnet_isapi.dll) version should handle the pages in the ASP.net application. The asp.net ISAPI version associated with the ASP.net application determines the version of the common language runtime that is used by the application. In IIS, the ASP.net application is associated with the ASP.net ISAPI version through a script map. To simplify the configuration process for asp.net applications, each asp.net version comes with a linked aspnet_regiis.exe version.

Note that each. NET Framework version comes with a unique aspnet_regiis.exe version. Because each version of the tool applies only to the. NET Framework version associated with it, it is important to configure the ASP.net application with the correct version of the tool.
Aspnet_regiis.exe is typically used with the-s or-SN option to remap the ASP.net application to the. NET Framework version associated with the tool. Use the-S option to update the application in the specified root path and all of its subdirectories. If you do not want to update the application in the subdirectory, use the-SN option. To update script mappings for all existing asp.net applications on your computer at the same time, use the-r option.

Note the path parameter refers to the root path of the application, not the physical path. For example, W3svc/1/root/sampleapp1.
Instead, by using the-K or-KN option and specifying the root path of the application, you can use the tool to remove any asp.net version of the script map from your application.

Note the-K and-KN options are not valid if the specified root path is the script map that inherits it from the parent root path.
The 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 the script mappings for all existing asp.net applications. Use the-ir option to install asp.net but not update script mappings. To uninstall the ASP.net version associated with the tool, use the-u option. If you want to uninstall all ASP.net versions from your computer, use the-ua option.

You can use Aspnet_regiis.exe to view information about asp.net. To list the status and installation path for all installed ASP.net versions, use the-LV option. If you want to see the path to all IIS metabase entries that contain asp.net mappings, use the-LK option.

You can use Aspnet_regiis.exe to install and remove client-side scripts, such as client-side validation. To install the ASP.net version of client script associated with this tool into the aspnet_client subdirectory of each IIS site directory, use the-C option. To remove only the ASP.net version of client script associated with the tool, use the-e option. To remove all installed ASP.net version of client script, use the-EA option.

For more information about parallel execution in ASP.net, see parallel (side-by-side) support in asp.net. For more information about script mappings and application root paths, see the IIS documentation (HTTP://LOCALHOST/IISHELP). Note that you must have IIS installed before you can view the IIS documentation.

Example
The following command installs a script map that points to the ASP.net version associated with aspnet_regiis.exe to the SAMPLEAPP1 application and all its child applications.

Aspnet_regiis-s W3svc/1/root/sampleapp1
The following command updates only the script mappings for the SAMPLEAPP1 application and does not affect the applications 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 mappings for all existing asp.net applications. Note that only applications that are currently mapped to an earlier ASP.net version are affected.

Aspnet_regiis-i
The following command installs the ASP.net version associated with the tool, but does not update the script mappings for existing asp.net applications.

Aspnet_regiis-ir
The following command displays the status and installation path for all ASP.net versions installed on the computer.

Aspnet_regiis-lv