ImportApp 命令
將 .msi 檔案中所包含的成品匯入 BizTalk 應用程式中。 如果應用程式不存在,會予以建立。
若您曾在應用程式中加入繫結檔案,以針對特定的部署環境進行自訂,則匯入應用程式時即可使用 /Environment 參數指定應用程式的目標部署環境。 如需背景資訊,請參閱 系結檔案和應用程式部署。 如需新增系結檔案的指示,請參閱 AddResource 命令:BizTalk 系結。
注意
匯入作業的持續時間一旦超過 3600 秒就會逾時。 如果您嘗試匯入某個 .msi 檔案而發生作業逾時,請重新匯出應用程式並分批選取所要匯出的部分成品,以將應用程式的內容分成多個 .msi 檔案。 如需詳細資訊,請參閱 如何匯出 BizTalk 應用程式。
如果匯入失敗,BTSTask 就會傳回顯示錯誤數目。 作業期間執行的大多數動作都會回復,唯獨下列情況例外:
自訂指令碼執行的動作不會回復。 您可以使用 Delete 環境變數撰寫可回復動作的指令碼。
安裝在全域組件快取 (GAC) 中的組件不會被移除。
Windows 登錄中的增修項目不會被移除。
如果匯入成功,BTSTask 會傳回 「0」。
使用方式
BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]
參數
參數 | 必要 | 值 |
---|---|---|
/Package (or /P, see Remarks) | Yes | .msi 檔案的完整路徑。 如果路徑包含空格,您必須將它括在雙引號 (") 中。 範例:"C:\My MSI Files\MyApplication.msi" |
/Environment (or /E, see Remarks) | No | 所套用之繫結檔案的目標部署環境,例如 Test。 此值係針對已加入應用程式中的繫結檔案指定其目標部署環境。 如果沒有指定,將會套用所有未指定部署環境的繫結。 |
/ApplicationName (或 /A,請參閱備註) | No | 要從 .msi 檔案匯入成品的 BizTalk 應用程式的名稱。 如果名稱包含空格,您必須將它括在雙引號 (") 中。 如果沒有指定,將會使用預設的應用程式。 如果指定的應用程式不存在,會自動建立應用程式。 |
/Overwrite (or /O, see Remarks) | No | 此選項指定以 .msi 檔案中,本機唯一識別碼 (LUID) 相同的成品覆寫應用程式中的成品。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。 若未指定此選項,且應用程式中有一或多個成品與 .msi 檔案中的成品具有相同的 LUID,匯入就會失敗。 |
/Server (or /S, see Remarks) | No | 裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱,其格式為:伺服器名稱\執行個體名稱,連接埠。 只有在執行個體名稱和伺服器名稱不同時,才需要執行個體名稱。 只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時,才需要連接埠。 範例: Server=MyServer Server=MyServer\MySQLServer,1533 如果不提供,將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。 |
/Database (or /D, see Remarks) | No | BizTalk 管理資料庫的名稱。 如果沒有指定,將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。 |
樣本
BTSTask ImportApp /Package:C:\MSI\MyApplication.msi /Environment:Test /ApplicationName:MyApplication /Overwrite
備註
參數不區分大小寫。 您不需要輸入整個參數名稱來指定它;您可以輸入參數名稱的前幾個字母,只要能明確識別就好了。