missice's Blog

當多個 .NET Framework 版本在單一電腦上並存執行時，對應到 ASP.NET 應用程式的 ASP.NET ISAPI 版本會決定這個應用程式要使用的 Common Language Runtime 版本。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 Metabase 根目錄及其下的程式碼對應。
注意 只會更新使用 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 Metabase 索引鍵的路徑和版本。
注意 從父索引鍵繼承 ASP.NET 指令碼對應的索引鍵不會顯示。
-lv 列出安裝在電腦上之所有 ASP.NET 版本的狀態和安裝路徑。
-r 更新 IIS Metabase 和其下的所有指令碼對應，以指向與 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 Information Services (IIS) 需要知道哪個 ASP.NET ISAPI (aspnet_isapi.dll) 版本應該處理 ASP.NET 應用程式中的網頁。與 ASP.NET 應用程式關聯的 ASP.NET ISAPI 版本會決定該應用程式要使用哪個 Common Language Runtime 版本。ASP.NET 應用程式是透過 IIS 中的指令碼對應與 ASP.NET ISAPI 版本建立關聯。為簡化 ASP.NET 應用程式的組態程序，每個 ASP.NET 版本都搭配了連結的 Aspnet_regiis.exe 版本。

注意 Aspnet_regiis.exe 的唯一版本包含在 .NET Framework 的每個版本中。因為每個版本的工具都只適用於相關的 .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 版本的指令碼對應。

注意 如果指定的根路徑從父根路=A