ASP.NET IIS 注册相关命令

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