asp.net|iis 當在一台電腦上並存執行多個 .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 版本。
注意 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 應用程式及其所有子應用程式。