ASP.NET IIS 註冊工具 (Aspnet_regiis.exe)

.NET Framework 附帶了兩個 IIS 註冊工具；一個用於標準系統，另外一個用於 64 位系統。
用於 64 位系統的工具位於 Windows 文件夾下 Microsoft.NET 目錄的 Framework64 目錄中；例如，C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727 將包含該 IIS 註冊工具。

aspnet_regiis [options]

選項

選項	說明
-c	將 ASP.NET 的客戶端腳本（如客戶端驗證腳本）安裝到每一個 Internet 信息服務 (IIS) 站點目錄的 aspnet_client 子目錄中。 只安裝與 Aspnet_regiis.exe 關聯的 ASP.NET 版本的客戶端腳本。
-disable	在 IIS 安全控制檯中禁用 ASP.NET。 此選項只能與 -i、-ir 或 -r 選項結合使用。此選項不能在 IIS 6.0 以前的 IIS 版本中使用。
-e	從每一個 IIS 站點目錄的 aspnet_client 子目錄中移除 ASP.NET 的客戶端腳本。 只移除與 Aspnet_regiis.exe 關聯的 ASP.NET 版本的客戶端腳本。
-ea	從每一個 IIS 站點目錄的 aspnet_client 子目錄中移除全部 ASP.NET 版本的客戶端腳本。
-enable	在 IIS 安全控制檯中啓用 ASP.NET。 此選項只能與 -i、-ir 或 -r 選項結合使用。此選項不能在 IIS 6.0 以前或 ASP.NET 2.0 版以前的版本中使用。
-gauser	向指定用戶授予 ASP.NET. 使用的 IIS 元數據庫和其餘目錄的訪問權限。 此選項不能在 ASP.NET 2.0 以前的版本中使用。
-i	安裝與 Aspnet_regiis.exe 關聯的 ASP.NET 版本，並更新 IIS 元數據庫根目錄和根目錄下的腳本映射。 只更新使用早期 ASP.NET 版本的應用程序的腳本映射。使用新版本的應用程序不受影響。
-ir	安裝與 Aspnet_regiis.exe 關聯的 ASP.NET 版本，並僅在 IIS 中註冊 ASP.NET。 此選項不更新腳本映射。若要安裝 ASP.NET 並更新腳本映射，請使用 -i 選項。
-kpath	在指定的應用程序根路徑及其子目錄中，從全部 ASP.NET 應用程序中移除全部 ASP.NET 版本的腳本映射。
-knpath	僅在指定的應用程序根路徑中，從 ASP.NET 應用程序中移除全部 ASP.NET 版本的腳本映射。 此選項不影響指定 path 的子目錄中的應用程序。
-lk	列出包含 ASP.NET 腳本映射的全部 IIS 元數據庫項的路徑和版本。 不顯示從父項繼承 ASP.NET 腳本映射的項。
-lv	列出計算機上安裝的全部 ASP.NET 版本的狀態和安裝路徑。
-norestart	禁止在安裝或更新 ASP.NET 腳本映射後從新啓動 IIS 輔助進程。 若是將手動從新啓動 IIS 輔助進程，則將此選項與 -i 或 -r 選項一塊兒使用。
-r	更新 IIS 元數據庫中及其下面的全部腳本映射，使其指向與 Aspnet_regiis.exe 關聯的 ASP.NET ISAPI 版本。 不管當前版本如何，都會更新現有的全部腳本映射，使其指向與 ASP.NET IIS 註冊工具關聯的 ASP.NET ISAPI 版本。
-spath	將腳本映射（該腳本映射指向與 Aspnet_regiis.exe 關聯的 ASP.NET ISAPI 版本）安裝到指定應用程序根路徑及其子目錄下的全部 ASP.NET 應用程序中。更新指定的路徑中及其下面使用早期 ASP.NET ISAPI 版本的全部現有腳本映射。
-snpath	將腳本映射（該腳本映射指向與該工具關聯的 ASP.NET ISAPI 版本）安裝到指定應用程序根路徑下的 ASP.NET 應用程序中。更新指定路徑中使用早期 ASP.NET ISAPI 版本的全部現有腳本映射。 此選項不影響 path 的子目錄中的應用程序。
-u	從計算機中卸載與 ASP.NET IIS 註冊工具關聯的 ASP.NET 版本。此 ASP.NET ISAPI 版本的現有腳本映射自動從新映射到其他已安裝的 ASP.NET ISAPI 的最新版本。
-ua	從計算機中卸載全部 ASP.NET 版本。
-?	顯示 ASP.NET IIS 註冊工具的命令語法和選項。

配置選項

選項	說明
-config+	容許對計算機上的 ASP.NET 配置進行遠程訪問。
-config-	禁止對計算機上的 ASP.NET 配置進行遠程訪問。
-pacontainer account	爲指定用戶或組 account 授予訪問指定項 container 的權限。此參數採用下面的可選修飾符： -pku   將默認的計算機容器替換爲用戶指定的容器。 -cspprovider   指定要使用的容器提供程序。 -full   指定應該添加徹底訪問權限而不是默認的只讀訪問權限。
-pccontainer	在指定容器中建立 RSA 公鑰/私鑰對。此參數採用下面的可選修飾符： -sizekeySize   指定密鑰大小。默認值爲 1024 字節。 -pku   將計算機上的默認密鑰容器替換爲用戶指定的容器。 -exp   指定必須能夠導出的私鑰。 -cspprovider   指定要使用的容器提供程序。
-pdsection	對配置節進行解密。此參數採用下面的可選參數： -appvirtualPath   指定應該在包含路徑的級別進行解密。 -locationsubPath   指定要解密的子目錄。 -pkm   指定應該對 Machine.config 而非 Web.config 文件進行解密。
-pdfsection webApplicationDirectory	對指定物理（非虛擬）目錄中的 Web.config 文件的指定配置節進行解密。
-pesection	對指定的配置節進行加密。此參數採用下面的可選修飾符： -provprovider   指定要使用的加密提供程序。 -appvirtualPath    指定應該在包含路徑的級別進行加密。 -locationsubPath   指定要加密的子目錄。 -pkm   指定應該對 Machine.config 而非 Web.config 文件進行加密。
-pefsection webApplicationDirectory	對指定物理（非虛擬）目錄中的 Web.config 文件的指定配置節進行加密。
-picontainer file	將 RSA 公鑰/私鑰對從指定的 XML file 導入指定的 container。此參數採用下面的可選修飾符： -pku   將默認的計算機容器替換爲用戶指定的容器。 -exp   指定能夠導出私鑰。 -cspprovider   指定要使用的容器提供程序。
-prcontainer account	移除指定的用戶或組 account 對指定的項 container 的訪問權限。此參數採用下面的可選修飾符： -pku   將默認的計算機容器替換爲用戶指定的容器。 -cspprovider   指定要使用的容器提供程序。
-pxcontainer file	將 RSA 公鑰/私鑰對從指定的容器導入指定的 XML 文件。此參數採用下面的可選修飾符： -pku   將默認的計算機容器替換爲用戶指定的容器。 -cspprovider   指定要使用的容器提供程序。
-pzcontainer	刪除指定的密鑰容器。此參數採用下面的可選修飾符： -pku   將默認的計算機容器替換爲用戶指定的容器。

備註

當在一臺計算機上安裝了多個 ASP.NET 版本時，就說 ASP.NET 是並行運行的。在此安裝中，Internet 信息服務 (IIS) 須要知道哪一個 ASP.NET ISAPI (aspnet_isapi.dll) 版本應該處理 ASP.NET 應用程序中的頁。與 ASP.NET 應用程序關聯的 ASP.NET ISAPI 版本決定了該應用程序使用的 CLR 版本。在 IIS 中，ASP.NET 應用程序經過腳本映射與 ASP.NET ISAPI 版本關聯。爲了簡化 ASP.NET 應用程序的配置過程，每一個 ASP.NET 版本都附帶了一個連接的 Aspnet_regiis.exe 版本。

注意
每一個 .NET Framework 版本都附帶一個惟一的 Aspnet_regiis.exe 版本。由於該工具的每一個版本只應用於與它關聯的 .NET Framework 版本，因此務必使用該工具的正確版本對 ASP.NET 應用程序進行配置。

ASP.NET IIS 註冊工具一般與 -s 或 -sn 選項結合使用，以便將 ASP.NET 應用程序從新映射到與該應用程序關聯的 .NET Framework 版本。使用 -s 選項，能夠更新指定根路徑及其全部子目錄中的應用程序。若是不須要更新子目錄中的應用程序，請使用 -sn 選項。若要同時更新計算機上現有的所有 ASP.NET 應用程序的腳本映射，請使用 -r 選項。

注意
path 參數引用的是應用程序的根路徑，而不是物理路徑。例如 W3SVC/1/ROOT/SampleApp1。

相反，經過使用 -k 或 -kn 選項並指定應用程序的根路徑，可使用 ASP.NET IIS 註冊工具從該應用程序中移除全部 ASP.NET 版本的腳本映射。若是指定的根路徑從父根路徑繼承它的腳本映射，-k 和 -kn 選項將無效。

ASP.NET IIS 註冊工具還能夠用於安裝和卸載 ASP.NET 的連接版本。使用 -i 選項，能夠安裝 ASP.NET，還能夠更新全部現有 ASP.NET 應用程序的腳本映射。使用 -ir 選項，能夠安裝 ASP.NET，但不更新腳本映射。若要卸載與該工具關聯的 ASP.NET 版本，請使用 -u 選項。若是要從計算機中卸載全部 ASP.NET 版本，請使用 -ua 選項。

另外，可使用 ASP.NET IIS 註冊工具查看有關 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) 支持。有關腳本映射和應用程序根路徑的更多信息，請參見http://www.microsoft.com/WindowsServer2003/iis/default.mspx 上有關 IIS 的文檔。

示例

下面的命令將腳本映射（這些腳本映射指向與該工具關聯的 ASP.NET 版本）安裝到 SampleApp1 應用程序及其全部子應用程序中。

複製代碼

aspnet_regiis -s W3SVC/1/ROOT/SampleApp1

下面的命令只更新 SampleApp1 應用程序的腳本映射，不影響子目錄中的應用程序。

複製代碼

aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1

下面的命令安裝與 ASP.NET IIS 註冊工具關聯的 ASP.NET 版本，並更新全部現有 ASP.NET 應用程序的腳本映射。注意，隻影響當前映射到早期 ASP.NET 版本的應用程序。

複製代碼

aspnet_regiis -i

下面的命令安裝與該工具關聯的 ASP.NET 版本，但不更新現有 ASP.NET 應用程序的腳本映射。

複製代碼

aspnet_regiis -ir

下面的命令顯示計算機上安裝的全部 ASP.NET 版本的狀態和安裝路徑。

複製代碼

aspnet_regiis -lv

應用文章:http://msdn.microsoft.com/zh-cn/k6h9cz8h(vs.80).aspx