When performing multiple .NET Framework versions on a computer, the ASP.NET ISAPI version that is mapped to the ASP.NET application determines the version of the public language running used by the application. ASP.NET IIS Registration Tool (ASPNET_REGIIS.exe) Enables administrators or installer to easily update script mapping of ASP.NET applications to point to the ASP.NET ISAPI version associated with the tool. This tool can also be used to display all installed ASP.NET versions, register the ASP.NET version coupled to the tool, create a client scripting directory, and perform other configuration operations.
ASPNET_REGIIS [Options]
You can specify one or more options below.
Option Description -c The ASP.NET's client script (such as client verification script) is installed into the ASPNET_CLIENT subdirectory of each IIS site directory.
Note that only the ASP.NET version of the ASP.NET version associated with ASPNET_REGIIS.exe is installed.
-e Remove the ASP.NET client script from the ASPNET_CLIENT subdirectory of each IIS site directory.
Note Only the ASP.NET version of the ASP.NET version associated with ASPNET_REGIIS.exe is removed.
-ea Removes all ASP.NET versions of client scripts from the ASPNET_CLIENT subdirectory of each IIS site directory. -i Install the ASP.NET version associated with ASPNET_REGIIS.exe and updates the IIS metadata library root directory and root maps.
Note Update the script mapping of applications using early ASP.NET versions. Using the new version of the application is not affected.
-ir installs the ASP.NET version associated with ASPNET_REGIIS.exe and register asp.net only in IIS.
Note This option does not update the script mapping. To install the ASP.NET and update the script map, please use
-i option.
-K path In the specified application root path and its subdirectories, all ASP.NET versions are removed from all ASP.NET applications. -kn path only in the specified application root path, removes all ASP.NET versions from the ASP.NET application.
Note that this option does not affect
Applications in the PATH subdirectory.
-lk lists the paths and versions of all IIS metadata library items that contain ASP.NET scripts.
Note that you do not display items from the parent inherited the ASP.NET script mapping.
-lv lists the status and installation paths of all ASP.NET versions installed on your computer. -r Updates all script mappings in the IIS meta database to point to the ASP.NET ISAPI version associated with ASPNET_REGIS.exe.
Note that all existing scripts will be updated to point to the ASP.NET ISAPI version associated with ASPNET_REGIS.EXE (independent of the current version).
-s path will point to the ASP.NET ISAPI version of the ASPNET_REGIIS.EXE version of the script map to install to the specified application root path and all ASP.NET applications in their subdirectory. Update all existing script mappings in the specified path and it uses the earlier ASP.NET ISAPI version. -SN path will point to the ASP.NET ISAPI version of the ASPNET_REGIIS.exe to install the ASP.NET application to the specified application root path. Update all existing script mappings using the early ASP.NET ISAPI versions in the specified path.
Note that this option does not affect
Applications in the PATH subdirectory.
-u Uninstall the ASP.NET version associated with ASPNET_REGIIS.exe from your computer. This ASP.NET ISAPI version of the existing script map is automatically re-mapped to the remaining version of the remaining ASP.NET ISAPI versions. -ua Uninstall all ASP.NET versions from your computer. -? Displays the command syntax and options for this tool. Note
When multiple ASP.NET versions are installed on a single computer, the ASP.NET is run in parallel. In this installation, Internet Information Services (IIS) requires which ASP.NET ISAPI (ASPNET_ISAPI.DLL) version should handle the page in the ASP.NET application. The ASP.NET ISAPI version associated with the ASP.NET application determines the version of the public language running library used by the application. In IIS, the ASP.NET application is associated with the ASP.NET ISAPI version through script mapping. To simplify the configuration process of the ASP.NET application, each ASP.NET version comes with a link for ASPNET_REGIS.EXE version.
Note that each .NET Framework version comes with a unique ASPNET_REGIS.EXE version. Since each version of the tool applies only to the .NET Framework version associated with it, you must use the correct version of the tool to configure the ASP.NET application.
ASPNET_REGIS.EXE is usually used with the -s or -sn option to re-map the ASP.NET application to the .NET Framework version associated with the tool. Use the -s option to update the specified root path and the application in all subdirectory. Use the -sn option if you don't want to update the application in the subdirectory. To update the script mapping of all existing ASP.NET applications on your computer, use the -r option.
note
Path parameter references the root path of the application, not a physical path. E.g,
W3SVC / 1 / Root / SampleApp1.
Instead, by using the -k or -kn option and specifies the root path of the application, you can use this tool to remove any ASP.NET version script mapping from the application.
Note If the specified root path is mapping it from the parent root path, then
-k and
The -kn option is invalid.
This tool can also be used to install and uninstall the ASP.NET versions of the link. Use the -i option to install the ASP.NET and update the script mapping of all existing ASP.NET applications. Use the -ir option to install ASP.NET but do not update script mapping. To uninstall the ASP.NET version associated with the tool, use the -u option. Use the -ua option if you want to uninstall all ASP.NET versions from your computer.
You can use ASPNET_REGIIS.EXE to view information about ASP.NET. To list all installed ASP.NET versions and installation paths, use the -lv option. Use the -lk option if you want to see all IIS metadata library items that contain the ASP.NET mapping.
You can use ASPNET_REGIIS.EXE to install and remove client scripts, such as client authentication. To install the ASP.NET version of the ASP.NET version of the tool to the ASPNET_CLIENT subdirectory of each IIS site directory, use the -c option. To remove only ASP.NET versions of the tool associated with the tool, use the -e option. To remove all installed ASP.NET versions of the client script, use the -ea option.
For more information on parallel implementation in ASP.NET, see the parallel (Side-by-side support in ASP.NET. For more information on script mapping and application root paths, see the IIS document (http: // localhost / Iishelp). Note that after IIS must be installed, you can view the IIS document. Example
The following command will point to the ASP.NET version of the ASP.NET version associated with the ASPNET_REGIIS.exe to install it to the SampleApp1 application and all its sub-applications.
ASPNET_REGIIS -S W3SVC / 1 / Root / SampleApp1
The following command updates the script mapping of the SampleApp1 application, does not affect 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 mapping of all existing ASP.NET applications. Note that only applications currently mapped to early ASP.NET versions.
ASPNET_REGIIS -I
The following command installs the ASP.NET version associated with the tool, but does not update the script mapping 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 your computer.
ASPNET_REGIIS -LV
