当在一台计算机上并行执行多个 .NET Framework 版本时,映射到 ASP.NET 应用程序的 ASP.NET ISAPI 版本决定了该应用程序所使用的公共语言运行库版本。ASP.NET IIS 注册工具 (Aspnet_regiis.exe) 使管理员或安装程序可以方便地更新 ASP.NET 应用程序的脚本映射,使其指向与该工具关联的 ASP.NET ISAPI 版本。该工具还可以用于显示所有已安装的 ASP.NET 版本的状态、注册与该工具耦合的 ASP.NET 版本、创建客户端脚本目录,以及执行其他配置操作。
Aspnet_regiis [options]
您可以指定以下一个或多个选项。
选项
说明
-c
将 ASP.NET 的客户端脚本(如客户端验证脚本)安装到每个 IIS 站点目录的 aspnet_client 子目录中。
注意 只安装与 Aspnet_regiis.exe 关联的 ASP.NET 版本的客户端脚本。
-e
从每个 IIS 站点目录的 aspnet_client 子目录中移除 ASP.NET 的客户端脚本。
注意 只移除与 Aspnet_regiis.exe 关联的 ASP.NET 版本的客户端脚本。
-ea
从每个 IIS 站点目录的 Aspnet_client 子目录中移除所有 ASP.NET 版本的客户端脚本。
-i
安装与 Aspnet_regiis.exe 关联的 ASP.NET 版本,并更新 IIS 元数据库根目录和根目录下的脚本映射。
注意 只更新使用早期 ASP.NET 版本的应用程序的脚本映射。使用新版本的应用程序不受影响。
-ir
安装与 Aspnet_regiis.exe 关联的 ASP.NET 版本并且仅在 IIS 中注册 ASP.NET。
注意 此选项不更新脚本映射。若要安装 ASP.NET 并更新脚本映射,请使用 -i 选项。
-k path
在指定的应用程序根路径及其子目录中,从所有 ASP.NET 应用程序中移除所有 ASP.NET 版本的脚本映射。
-kn path
仅在指定的应用程序根路径中,从 ASP.NET 应用程序中移除所有 ASP.NET 版本的脚本映射。
注意 该选项不影响 path 子目录中的应用程序。
-lk
列出包含 ASP.NET 脚本映射的所有 IIS 元数据库项的路径和版本。
注意 不显示从父项继承 ASP.NET 脚本映射的项。
-lv
列出计算机上安装的所有 ASP.NET 版本的状态和安装路径。
-r
更新 IIS 元数据库中及其下面的所有脚本映射,使其指向与 Aspnet_regiis.exe 关联的 ASP.NET ISAPI 版本。
注意 所有现有的脚本映射都会更新,以指向与 Aspnet_regiis.exe 关联的 ASP.NET ISAPI 版本(与当前版本无关)。
-s path
将指向与 Aspnet_regiis.exe 关联的 ASP.NET ISAPI 版本的脚本映射安装到指定的应用程序根路径及其子目录下的所有 ASP.NET 应用程序中。更新指定的路径中及其下面使用早期 ASP.NET ISAPI 版本的所有现有脚本映射。
-sn path
将指向与 Aspnet_regiis.exe 关联的 ASP.NET ISAPI 版本的脚本映射安装到指定应用程序根路径下的 ASP.NET 应用程序中。更新指定路径中使用早期 ASP.NET ISAPI 版本的所有现有脚本映射。
注意 该选项不影响 path 子目录中的应用程序。
-u
从计算机中卸载与 Aspnet_regiis.exe 关联的 ASP.NET 版本。此 ASP.NET ISAPI 版本的现有脚本映射自动重新映射到其余已安装的 ASP.NET ISAPI 版本中的最高版本。
-ua
从计算机中卸载所有 ASP.NET 版本。
-?
显示此工具的命令语法和选项。
备注
当在一台计算机上安装了多个 ASP.NET 版本时,就说 ASP.NET 是并行运行的。在此安装中,Internet 信息服务 (IIS) 需要知道哪个 ASP.NET ISAPI (aspnet_isapi.dll) 版本应该处理 ASP.NET 应用程序中的页。与 ASP.NET 应用程序关联的 ASP.NET ISAPI 版本决定了该应用程序所使用的公共语言运行库版本。在 IIS 中,ASP.NET 应用程序通过脚本映射与 ASP.NET ISAPI 版本关联。为了简化 ASP.NET 应用程序的配置过程,每个 ASP.NET 版本都附带了一个链接的 Aspnet_regiis.exe 版本。
注意 每个 .NET Framework 版本都附带一个唯一的 Aspnet_regiis.exe 版本。由于该工具的每个版本只适用于与它关联的 .NET Framework 版本,所以一定要使用该工具的正确版本来配置 ASP.NET 应用程序。
Aspnet_regiis.exe 通常与 -s 或 -sn 选项一起使用,以将 ASP.NET 应用程序重新映射到与该工具关联的 .NET Framework 版本。使用 -s 选项可更新指定的根路径及其所有子目录中的应用程序。如果不想更新子目录中的应用程序,请使用 -sn 选项。若要同时更新计算机上的所有现有 ASP.NET 应用程序的脚本映射,请使用 -r 选项。
注意 path 参数引用应用程序的根路径,而不是物理路径。例如,W3SVC/1/ROOT/SampleApp1。
相反,通过使用 -k 或 -kn 选项并指定应用程序的根路径,可以使用该工具从应用程序中移除任何 ASP.NET 版本的脚本映射。
注意 如果指定的根路径是从父根路径继承它的脚本映射,则 -k 和 -kn 选项无效。
该工具还可以用于安装和卸载链接的 ASP.NET 版本。使用 -i 选项可安装 ASP.NET 并更新所有现有 ASP.NET 应用程序的脚本映射。使用 -ir 选项可安装 ASP.NET 但不更新脚本映射。若要卸载与该工具关联的 ASP.NET 版本,请使用 -u 选项。如果想从计算机中卸载所有 ASP.NET 版本,请使用 -ua 选项。
可以使用 Aspnet_regiis.exe 查看有关 ASP.NET 的信息。若要列出所有已安装的 ASP.NET 版本的状态和安装路径,请使用 -lv 选项。如果想查看包含 ASP.NET 映射的所有 IIS 元数据库项的路径,请使用 -lk 选项。
可以使用 Aspnet_regiis.exe 安装和移除客户端脚本,如客户端验证。若要将与该工具关联的 ASP.NET 版本的客户端脚本安装到每个 IIS 站点目录的 aspnet_client 子目录中,请使用 -c 选项。若要只移除与该工具关联的 ASP.NET 版本的客户端脚本,请使用 -e 选项。若要移除所有已安装的 ASP.NET 版本的客户端脚本,请使用 -ea 选项。
有关 ASP.NET 中并行执行的更多信息,请参见 ASP.NET 中的并行 (Side-by-Side) 支持。有关脚本映射和应用程序根路径的更多信息,请参见 IIS 文档 (http://localhost/iishelp)。注意,必须安装了 IIS 之后,才能查看 IIS 文档。
示例
下面的命令将指向与 Aspnet_regiis.exe 关联的 ASP.NET 版本的脚本映射安装到 SampleApp1 应用程序及其所有子应用程序。
Aspnet_regiis -s W3SVC/1/ROOT/SampleApp1
下面的命令只更新 SampleApp1 应用程序的脚本映射,不影响子目录中的应用程序。
Aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1
下面的命令安装与该工具关联的 ASP.NET 版本并更新所有现有 ASP.NET 应用程序的脚本映射。注意,只影响当前映射到早期 ASP.NET 版本的应用程序。
Aspnet_regiis -i
下面的命令安装与该工具关联的 ASP.NET 版本,但不更新现有 ASP.NET 应用程序的脚本映射。
Aspnet_regiis -ir
下面的命令显示计算机上安装的所有 ASP.NET 版本的状态和安装路径。
Aspnet_regiis -lv