如何匯出 BizTalk 應用程式

發行項
10/14/2023

本主題說明如何使用 BizTalk Server 管理主控台或命令列匯出應用程式。匯出 BizTalk 應用程式會產生 Windows Installer (.msi) 檔案，此檔案包含該應用程式及其中您選擇匯出的任何成品。預設選項為選取該應用程式的所有成品，但您可選取其子集。然後您可將 .msi 檔案匯入另一個 BizTalk 群組，將成品新增至新群組中的現有應用程式、更新現有應用程式中的成品，或在包含要匯入之成品的群組中建立新的應用程式。如需詳細資訊，請參閱如何匯入 BizTalk 應用程式。您也可以使用 .msi 檔案，在將執行該應用程式的電腦上安裝應用程式，如如何安裝 BizTalk 應用程式中所述。如果應用程式包含以檔案為基礎的成品，您還必須先安裝它之後才能開始運作。

匯出應用程式時，請牢記下列要點：

匯入的繫結會自動覆寫現有的繫結。 如果您不希望正在匯出之應用程式中的繫結覆寫將匯入 .msi 檔案之應用程式中的繫結，則您不應該選取繫結檔案做為要匯出的資源。當您匯入包含繫結檔案的 .msi 檔案到現有的應用程式中時，所匯入的繫結會覆寫現有的繫結，即使您並未選取覆寫現有成品的選項。
在您匯出應用程式時，使用者仍可對成品進行變更。 如果使用者正在修改資料庫型成品，例如虛擬目錄、憑證或原則，而匯出作業正在進行中，則變更將不會反映在匯出的 .msi 檔案中。因此，Microsoft 建議您將匯出作業排定在使用者可能不會對這些成品進行變更的時間。
在Windows Vista 上安裝 .msi 時，可能會顯示不正確的錯誤。安裝使用 BizTalk Server 匯出的 .msi 套件時，您可能會收到下列不正確的錯誤：「安裝程式安裝此套件時發生意外的錯誤。這可能表示封裝有問題。錯誤碼為 2869。」若要更正此錯誤，請先使用 BizTalk Server 匯入 .msi 套件，然後重新匯出並安裝套件。
應用程式可能會對另一個應用程式有相依性。 這可能影響您部署應用程式的方式。如需詳細資訊，請參閱相依性和應用程式部署。
匯出之前，您可以修改應用程式中資源的目的地目錄。 如果您想要變更目的地位置，請展開應用程式的資源節點，以滑鼠右鍵按一下您要變更的資源，然後選擇 [ 修改]。在 [修改資源] 對話方塊中，輸入 [ 目的地位置] 的新位置。
如果應用程式包含已從規則引擎資料庫移除的原則，匯出將會失敗。 當您使用規則引擎部署精靈從規則引擎資料庫移除原則後，在「未發佈」狀態下它會顯示在管理主控台中，且您無法匯出該應用程式。如需規則引擎部署精靈的詳細資訊，請參閱如何部署和取消部署原則和詞彙。

重要

.msi 檔案可能包含機密資料。請確定執行步驟以確保檔案是安全的。如需詳細資訊，請參閱安全性和 Windows Installer。

在應用程式匯出期間，密碼會從應用程式繫結移除。從 .msi 檔案安裝應用程式後，您必須重新設定密碼，應用程式才能運作。然而，密碼不會從您新增至應用程式的任何繫結檔案移除。

如果應用程式包含使用 Web 服務的網站或協調流程，請注意虛擬目錄上的安全性設定，就是在應用程式匯出期間產生 .msi 檔案時生效的那些安全性設定。如果您將應用程式部署到實際執行環境，則在匯出應用程式之前，應該驗證設定是否符合安全性需求。如果虛擬目錄已存在於主機電腦，其安全性設定不會被覆寫，但應用程式中的檔案會新增至該虛擬目錄。在應用程式匯入後，您應驗證安全性設定。

當應用程式匯出時，所有的判別存取控制清單 (DACL) 都會從檔案和資料夾中移除。安裝應用程式之後，您應該重新設定檔案和資料夾上的所有安全性設定，包括虛擬目錄。

注意

如果匯出作業失敗，BizTalk Server 會刪除所有的暫存檔案以及 .msi 檔案 (若已建立)。

必要條件

若要執行這個主題中的程序，您必須使用「BizTalk Server 系統管理員」群組成員的帳戶登入。如需許可權的詳細資訊，請參閱部署和管理 BizTalk 應用程式所需的許可權。此外，還必須安裝「商務規則引擎」。如需詳細資訊，請參閱安裝BizTalk Server。

使用BizTalk Server管理匯出應用程式

依序按一下[開始]、[所有程式]、[Microsoft BizTalk Server 20xx]，然後按一下 [BizTalk Server系統管理]。
在主控台樹中，依序展開 [BizTalk Server [系統管理]、[BizTalk] 群組，然後展開 [應用程式]。
以滑鼠右鍵按一下您要匯出的應用程式，指向 [ 匯出]，然後按一下 [MSI 檔案]。
在 [歡迎使用匯出 MSI 檔案精靈] 頁面上，按 [ 下一步]。
在 [選取資源] 頁面上，選取要匯出至 .msi 檔案的成品，然後按 [ 下一步]。
如果出現提示，請在 [指定 IIS 主機] 頁面上，輸入裝載您要包含之虛擬目錄之電腦的伺服器名稱，然後按 [ 下一步]。只有在虛擬目錄先前已新增至 BizTalk 管理資料庫，例如已新增至應用程式或匯入應用程式時，系統才會提示您指定伺服器。
在 [相依性] 頁面上，檢閱應用程式的相依性，然後按 [ 下一步]。
在 [目的地] 頁面的 [目的地應用程式名稱] 中，輸入應用程式名稱。
在 要產生的 MSI 檔案中，輸入 .msi 檔案的完整路徑，然後按一下 [ 匯出]。範例：C:\MSI\Errorhandling.msi

注意

Microsoft 建議您將 .msi 檔案儲存在安全的資料夾中。
在 [摘要] 頁面上，記下此作業記錄檔的位置，然後按一下 [ 完成]。

使用命令列匯出應用程式

開啟命令提示字元，如下所示：按一下 [ 開始]，按一下 [ 執行]，輸入 cmd ，然後按一下 [ 確定]。

輸入下列命令，並以適當的值替代，如下表所述：

BTSTask ExportApp [/ApplicationName：value] /Package：value [ResourceSpec：value [/Server：value] [/Database：value]

注意

在支援使用者帳戶控制 (UAC) 的系統上，您可能需要使用系統管理權限來執行工具。

範例：

BTSTask ExportApp /ApplicationName:MyApplication /Package:C:/MSI/MyApplication.msi /ResourceSpec:"C:\My Files\ResourceSpec.xml" /Server:MySQLServer /Database:BizTalkMgmtDb

您所指定的成品會匯入至指定位置的 .msi 檔案中。

參數	值
/ApplicationName	要匯出的 BizTalk 應用程式的名稱。如果沒有指定應用程式名稱，將會使用預設的 BizTalk 應用程式。如果名稱包含空格，必須以雙引號 (") 將其括住。
/包	要建立之 .msi 檔案的路徑，包含其檔案名稱。
/ResourceSpec	資源規格 XML 檔案的路徑，包含檔案名稱。您可以藉由編輯資源規格 XML 檔案來指定要匯出的成品，此檔案是在您使用 ResourceSpec 參數執行 ListApp 命令時所建立，如 ListApp 命令中所述。您必須手動編輯此檔案，在 Web 伺服器位於遠端電腦上時，為您想匯出的虛擬目錄新增 Internet Information Services (IIS) 主機伺服器名稱。
/伺服器	裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱，其格式為：伺服器名稱\執行個體名稱,連接埠。只有在執行個體名稱和伺服器名稱不同時，才需要執行個體名稱。只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時，才需要連接埠。範例： Server=MyServer Server=MyServer\MySQLServer,1533 如果不提供，將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。
/資料庫	BizTalk 管理資料庫的名稱。如果沒有指定，將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。

另請參閱

匯出 BizTalk 應用程式、繫結和原則
 ExportApp 命令

共用方式為