安裝程式工具 (Installutil.exe)
安裝程式工具使您得以通過在執行指定程式集中的安裝程式組件來安裝和卸載伺服器資源。此工具與 System.Configuration.Install 命名空間中的類一起工作。安轉的位置和路徑在:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe
卸載的位置和路徑在:
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe 安裝程式工具 (Installutil.exe) 安裝方法和參數:安裝程式工具 (Installutil.exe) 安裝方法和參數:installutil [/uninstall][option [...]]assemblyname ][option [...]]assemblyname
| /h[elp] |
顯示該工具的命令文法和選項。 |
| /help assemblypath |
顯示指定程式集中的個別安裝程式所識別的任何附加選項。 |
| /? |
顯示該工具的命令文法和選項。 |
| /? assemblypath |
顯示指定程式集中的個別安裝程式所識別的任何附加選項。 |
| /LogFile=[filename] |
指定在其中記錄安裝進度的記錄檔的名稱。預設檔案名稱是 assemblyname.InstallLog。 |
| /AssemblyName assemblyName [,Version=major.minor.build.revision][,Culture=locale][,PublicKeyToken=publicKeyToken]] |
指定程式集的名稱。必須使用程式集的版本、地區性和公開金鑰標記完全限定程式集名稱。完全限定名必須用引號括起。例如,“myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=2.0.0.0”是完整程式集名稱。 |
| /LogToConsole={true|false} |
如果為 true,則將輸出顯示到控制台。如果為 false(預設值),則取消將輸出顯示到控制台。 |
| /ShowCallStack |
如果在安裝過程中的任何時候出現異常,則將呼叫堆疊列印到日誌。 |
備註
可以在同一個命令列上指定多個程式集。出現在程式集名稱前面的任何選項應用於該程式集的安裝。為某個程式集指定的選項應用於後面的任何程式集,除非該選項與新程式集名稱一起指定。
Microsoft .NET Framework
應用程式由傳統的程式檔案和關聯資源組成,如必須在部署應用程式時創建的訊息隊列、事件日誌和效能計數器。安裝應用程式時可以使用程式集的安裝程式組件創
建這些資源,而在卸載應用程式時可以使用這些組件刪除這些資源。Installutil.exe 檢測並執行這些安裝程式組件。
如果對某個程式集運行 Installutil.exe 但不指定任何選項,則 Installutil.exe 將下面三個檔案放到該程式集的目錄中:
Installutil.exe 使用反射檢查指定的程式集並尋找將 RunInstallerAttribute 設置為 true 的所有 Installer 類型。然後此工具在 Installer 類型的每個實例上執行 Install 方法或 Uninstall 方法。Installutil.exe 以事務性方式執行安裝;如果有一個程式集未能安裝,則 Installutil.exe 回滾其他所有程式集的安裝。卸載不是事務性的。
請註意,不能使用 Installutil.exe 來部署用 C++ 的託管擴展創建的 Windows 服務。Installutil.exe
無法識別由 C++ 編譯器產生的嵌入的本機代碼。如果試圖使用 Installutil.exe 來部署託管擴展 Windows
服務,則會引發異常(如 BadImageFormatException)。要處理這種情況,請將服務代碼移動到 C++ 的託管擴展模塊。然後,用 C# 或 Visual Basic 來編寫安裝程式對象。
樣本
下列命令顯示命令語法和選項的說明。
installutil
下面的命令執行 myAssembly.exe 程式集中的安裝程式組件。
installutil myAssembly.exe
下面的命令執行 myAssembly.exe 程式集中的卸載程式組件。
installutil /u myAssembly.exe
下面的命令執行 myAssembly.exe 程式集中的安裝程式並指定將進度資訊寫入 myLog.InstallLog 中。
installutil /LogFile=myLog.InstallLog myAssembly.exe
下面的命令將 myAssembly.exe 的安裝進度寫入 myLog.InstallLog 中,並將 myTestAssembly.exe 的進度寫入 myTestLog.InstallLog 中。
installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile = myTestLog.InstallLog myTestAssembly.
安裝程式工具 (Installutil.exe)
安裝程式工具使您得以通過在執行指定程式集中的安裝程式組件來安裝和卸載伺服器資源。此工具與 System.Configuration.Install 命名空間中的類一起工作。安轉的位置和路徑在:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe
卸載的位置和路徑在:
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe 安裝程式工具 (Installutil.exe) 安裝方法和參數:安裝程式工具 (Installutil.exe) 安裝方法和參數:installutil [/uninstall][option [...]]assemblyname ][option [...]]assemblyname
| /h[elp] |
顯示該工具的命令文法和選項。 |
| /help assemblypath |
顯示指定程式集中的個別安裝程式所識別的任何附加選項。 |
| /? |
顯示該工具的命令文法和選項。 |
| /? assemblypath |
顯示指定程式集中的個別安裝程式所識別的任何附加選項。 |
| /LogFile=[filename] |
指定在其中記錄安裝進度的記錄檔的名稱。預設檔案名稱是 assemblyname.InstallLog。 |
| /AssemblyName assemblyName [,Version=major.minor.build.revision][,Culture=locale][,PublicKeyToken=publicKeyToken]] |
指定程式集的名稱。必須使用程式集的版本、地區性和公開金鑰標記完全限定程式集名稱。完全限定名必須用引號括起。例如,“myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=2.0.0.0”是完整程式集名稱。 |
| /LogToConsole={true|false} |
如果為 true,則將輸出顯示到控制台。如果為 false(預設值),則取消將輸出顯示到控制台。 |
| /ShowCallStack |
如果在安裝過程中的任何時候出現異常,則將呼叫堆疊列印到日誌。 |
備註
可以在同一個命令列上指定多個程式集。出現在程式集名稱前面的任何選項應用於該程式集的安裝。為某個程式集指定的選項應用於後面的任何程式集,除非該選項與新程式集名稱一起指定。
Microsoft .NET Framework
應用程式由傳統的程式檔案和關聯資源組成,如必須在部署應用程式時創建的訊息隊列、事件日誌和效能計數器。安裝應用程式時可以使用程式集的安裝程式組件創
建這些資源,而在卸載應用程式時可以使用這些組件刪除這些資源。Installutil.exe 檢測並執行這些安裝程式組件。
如果對某個程式集運行 Installutil.exe 但不指定任何選項,則 Installutil.exe 將下面三個檔案放到該程式集的目錄中:
Installutil.exe 使用反射檢查指定的程式集並尋找將 RunInstallerAttribute 設置為 true 的所有 Installer 類型。然後此工具在 Installer 類型的每個實例上執行 Install 方法或 Uninstall 方法。Installutil.exe 以事務性方式執行安裝;如果有一個程式集未能安裝,則 Installutil.exe 回滾其他所有程式集的安裝。卸載不是事務性的。
請註意,不能使用 Installutil.exe 來部署用 C++ 的託管擴展創建的 Windows 服務。Installutil.exe
無法識別由 C++ 編譯器產生的嵌入的本機代碼。如果試圖使用 Installutil.exe 來部署託管擴展 Windows
服務,則會引發異常(如 BadImageFormatException)。要處理這種情況,請將服務代碼移動到 C++ 的託管擴展模塊。然後,用 C# 或 Visual Basic 來編寫安裝程式對象。
樣本
下列命令顯示命令語法和選項的說明。
installutil
下面的命令執行 myAssembly.exe 程式集中的安裝程式組件。
installutil myAssembly.exe
下面的命令執行 myAssembly.exe 程式集中的卸載程式組件。
installutil /u myAssembly.exe
下面的命令執行 myAssembly.exe 程式集中的安裝程式並指定將進度資訊寫入 myLog.InstallLog 中。
installutil /LogFile=myLog.InstallLog myAssembly.exe
下面的命令將 myAssembly.exe 的安裝進度寫入 myLog.InstallLog 中,並將 myTestAssembly.exe 的進度寫入 myTestLog.InstallLog 中。
installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile = myTestLog.InstallLog myTestAssembly.