ASP.NET IIS 注冊工具 (Aspnet_regiis.exe)
2024-07-10 12:57:02
供稿：網友
當在一臺計算機上并行執行多個 .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
