How to and when to use ASP.NET IIS Registration Tool.
If .NET framework is installed before IIS then we get this problem "Server application unavailable" when we run any application on IIS.
For this we need to register ASP.NET with IIS.
Go to command promt and go to .NET directory (C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727).
Then run this command aspnet_regiis -i for registering ASP.NET runtime with IIS. and aspnet_regiis -c for installing client side scripts.
The tool can also be used to determine which version of the common language runtime (CLR) is used for the application and also to display the status of all installed versions of ASP. NET, register the ASP.NET version that is coupled with the tool, create client-script directories, and perform other configuration operations.
Below are the options that we get with this tool.
Option Description
-c
Installs the client-side scripts for ASP.NET, such as client-side validation scripts, to the aspnet_client subdirectory of each Internet Information Services (IIS) site directory.
Only the client-side scripts for the ASP.NET version that is associated with Aspnet_regiis.exe are installed.
-disable
Disables ASP.NET in the IIS Security Console.
This option can be combined only with the -i, -ir, or -r options. It is not available with IIS versions earlier than IIS 6.0.
-e
Removes the client-side scripts for ASP.NET from the aspnet_client subdirectory of each IIS site directory.
Only the client-side scripts for the ASP.NET version associated with Aspnet_regiis.exe are removed.
-ea
Removes the client-side scripts for all versions of ASP.NET from the aspnet_client subdirectory of each IIS site directory.
-enable
Enables ASP.NET in the IIS Security Console.
This option can be combined only with the -i, -ir, or -r options. It is not available with IIS versions earlier than IIS 6.0 or with ASP.NET versions earlier than ASP.NET version 2.0.
-ga user
Grants the specified user or group access to the IIS metabase and other directories that are used by ASP.NET.
This option is not available with ASP.NET versions earlier than ASP.NET 2.0.
-i
Installs the version of ASP.NET that is associated with Aspnet_regiis.exe and updates the script maps at the IIS metabase root and below.
Only the script maps for applications that use an earlier version of ASP.NET are updated. Applications that use a later version are not affected.
-ir
Installs the version of ASP.NET that is associated with Aspnet_regiis.exe and only registers ASP.NET in IIS.
This option does not update the script maps. To install ASP.NET and update the script maps, use the -i option.
-k path
Removes the script maps to all versions of ASP.NET from all ASP.NET applications at the specified application root path and its subdirectories.
-kn path
Removes the script maps to all versions of ASP.NET from the ASP.NET application only at the specified application root path.
This option does not affect applications in subdirectories of the specified path.
-lk
Lists the path and version of all IIS metabase keys where ASP.NET is mapped.
The keys that inherit ASP.NET script maps from a parent key are not displayed.
-lv
Lists the status and installation path of all versions of ASP.NET that are installed on the computer.
-norestart
Inhibits the restart of the World Wide Web Publishing Service after installing or updating ASP.NET script maps. If you do not use this option, all application pools are recycled.
Use this option with the -i or -r options when the IIS worker process will be restarted manually.
-r
Updates all of the script maps in the IIS metabase and below to point to the ASP.NET ISAPI version that is associated with Aspnet_regiis.exe.
All existing script maps are updated to point to the ASP.NET ISAPI version that is associated with the ASP.NET IIS Registration tool, 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 at the specified application root path and its subdirectories. All existing script maps in the specified path and below that use an earlier version of the ASP.NET ISAPI are updated.
-sn path
Installs the script map that points to the ASP.NET ISAPI version associated with the tool to the ASP.NET application at the specified application root path. All existing script maps in the specified path that use an earlier version of the ASP.NET ISAPI are updated.
This option does not affect applications in subdirectories of path.
-u
Uninstalls the version of ASP.NET that is associated with the ASP.NET IIS Registration tool from the computer. Existing script maps to this version of the ASP.NET ISAPI are automatically remapped to the most recent remaining ASP.NET ISAPI version installed.
-ua
Uninstalls all versions of ASP.NET from the computer.
-?
Displays the command syntax and options for the ASP.NET IIS Registration tool.
Configuration Options
Option Description
-config+
Enables remote access to ASP.NET configuration on the computer.
-config-
Disables remote access to ASP.NET configuration on the computer.
-pa container account
Grants permission for the specified user or group account to access the specified key container. This argument takes the following optional modifiers:
-pku Substitutes a user-specified container for the default machine container.
-csp provider Specifies the container provider to use.
-full Specifies that full access should be added, rather than the default read-only access.
-pc container
Creates an RSA public/private key pair in the specified container. This argument takes the following optional modifiers:
-size keySize Specifies the key size. The default is 1024 bytes.
-pku Substitutes a user-specified container for the default key container on the computer.
-exp Specifies that private keys must be able to be exported.
-csp provider Specifies the container provider to use.
-pd section
Decrypts the configuration section. This argument takes the following optional parameters:
-app virtualPath Specifies that decryption should occur at the level of the included path.
-location subPath Specifies the subdirectory to decrypt.
-pkm Specifies that the Machine.config file should be decrypted instead of the Web.config file.
-pdf section webApplicationDirectory
Decrypts the specified configuration section of the Web.config file in the specified physical (not virtual) directory.
-pe section
Encrypts the specified configuration section. This argument takes the following optional modifiers:
-prov provider Specifies the encryption provider to use.
-app virtualPath Specifies that encryption should occur at the level of the included path.
-location subPath Specifies the subdirectory to encrypt.
-pkm Specifies that the Machine.config file should be encrypted instead of the Web.config file.
-pef section webApplicationDirectory
Encrypts the specified configuration section of the Web.config file in the specified physical (not virtual) directory.
-pi container file
Imports an RSA public/private key pair to the specified container from the specified XML file. This argument takes the following optional modifiers:
-pku Substitutes a user-specified container for the default machine container.
-exp Specifies that private keys can be exported.
-csp provider Specifies the container provider to use.
-pr container account
Removes permission for the specified user or group account to access the specified key container. This argument takes the following optional modifiers:
-pku Substitutes a user-specified container for the default machine container.
-csp provider Specifies the container provider to use.
-px container file
Exports an RSA public/private key pair from the specified container to the specified XML file. This argument takes the following optional modifiers:
-pku Substitutes a user-specified container for the default machine container.
-csp provider Specifies the container provider to use.
-pz container
Deletes the specified key container. This argument takes the following optional modifier:
-pku Substitutes a user-specified container for the default machine container.
