如何將 BizTalk 組件新增至應用程式

發行項
10/14/2023

本主題描述如何使用 BizTalk Server 管理主控台或命令列，將 BizTalk 組件新增至應用程式。

當您新增 BizTalk 組件至應用程式時，請牢記下列要點：

如果您想要新增和覆寫的組件，具有與應用程式中現有組件相同的本機唯一識別碼 (LUID)，請指定 Overwrite 選項。若未指定此選項，且應用程式中現有的組件與所加入的組件具有相同的 LUID，則作業將會失敗。 LUID 包含元件檔案名、版本、文化特性和公開金鑰權杖。您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。
如果您要加入的組件與未包含在此應用程式中的其他成品具有相依性，新增作業將會失敗。
新增 BizTalk 組件時，您可以指定下列的一或多個選項，將組件安裝到全域組件快取 (GAC)。
- 新增至新增資源上的全域組件快取 (gacutil)： 如果選取此選項，當您使用本主題中的程序新增組件至應用程式時，會將組件安裝在本機電腦上的 GAC 中。
- 新增至 MSI 檔案匯入上的全域組件快取 (gacutil)： 選取此選項時，如果應用程式是匯出至 .msi 檔案，而 .msi 檔案又會匯出至 BizTalk 群組中，則匯出程序會將組件安裝在本機電腦上的 GAC 中。
- 新增至 MSI 檔案安裝上的全域組件快取 (gacutil)： 選取此選項時，如果應用程式是匯出至 .msi 檔案，再由 .msi 檔案將應用程式安裝在電腦上，則安裝程序會將組件安裝在本機電腦上的 GAC 中。

必要條件

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

將 BizTalk 組件新增至應用程式

使用 BizTalk Server 管理主控台

依序按一下[開始]、[所有程式]、[Microsoft BizTalk Server 20xx]，然後按一下[BizTalk Server系統管理]。
在主控台樹中，展開 BizTalk Server Administration 和 BizTalk 群組，其中包含您要新增 BizTalk 元件的應用程式。
展開 [應用程式]，再展開您想要在其中新增 BizTalk 組件的應用程式。
以滑鼠右鍵按一下 [資源]，指向 [ 新增 ]，然後按一下 [BizTalk 元件]。
按一下 [新增]，選取 BizTalk 元件檔案，然後按一下 [ 開啟]。
在 [目的地] 中，輸入從 .msi 檔案安裝應用程式時，要複製元件檔案之位置的完整路徑，包括檔案名。如果不提供，安裝期間就不會將組件檔案複製到本機檔案系統。
在 [選項] 中，指定將 BizTalk 元件安裝至 GAC 的選項，然後按一下 [ 確定]。

使用命令列

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

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

BTSTask AddResource [/ApplicationName：value] /Type：System.BizTalk：BizTalkAssembly [/Overwrite] /Source：value [/Destination：value] [/Options：GacOnAdd|GacOnInstall|GacOnImport] [/Server：value] [/Database：value]

範例：

BTSTask AddResource /ApplicationName：MyApplication /Type：System.BizTalk：BizTalkAssembly /Overwrite /Source：「C：\BizTalk Assemblies\MyOrchestration.dll」 /Destination：「C：\New BizTalk 元件\ MyOrchestration.dll 」 /Server：MyDatabaseServer /Database：BizTalkMgmtDb

參數	值
/ApplicationName	加入 BizTalk 組件之 BizTalk 應用程式的名稱。如果沒有指定應用程式名稱，將會使用預設的 BizTalk 應用程式。如果名稱包含空格，您必須將它括在雙引號 (") 中。
/類型	System.BizTalk:BizTalkAssembly
/覆蓋	此選項指定更新現有的組件。若未指定此選項，且應用程式中現有的組件與所加入的組件具有相同的 LUID，AddResource 作業將會失敗。您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。如果其他應用程式相依於即將覆寫的組件，則即使指定此參數，AddResource 作業也會失敗。
/源	組件檔案的完整路徑 (包含檔案名稱)。如果路徑包含空格，您必須將它括在雙引號 (") 中。
/目的地	從 .msi 檔案安裝應用程式時，組件檔案之複製目的位置的完整路徑。如果不提供，安裝期間就不會將組件檔案複製到本機檔案系統。如果路徑包含空格，您必須將它括在雙引號 (") 中。
/選項	- GacOnAdd：指定在 AddResource 作業期間，將元件安裝到本機電腦上的全域組件快取 (GAC) 。 - GacOnInstall：指定從 .msi 檔案安裝應用程式時，將元件安裝至 GAC。 - GacOnImport：指定在匯入應用程式 .msi 檔案時，將元件安裝至 GAC。您必須以逗點分隔多個選項。
/伺服器	裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱，其格式為：伺服器名稱\執行個體名稱,連接埠。只有在執行個體名稱和伺服器名稱不同時，才需要執行個體名稱。只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時，才需要連接埠。範例： Server=MyServer Server=MyServer\MySQLServer,1533 如果不提供，將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。
/資料庫	BizTalk 管理資料庫的名稱。如果沒有指定，將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。

另請參閱

管理 BizTalk 組件
 AddResource 命令：BizTalk 組件

共用方式為