共用方式為


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

本主題描述如何使用 BizTalk Server 管理控制台或命令行,將 BizTalk 元件新增至應用程式。

將 BizTalk 元件新增至應用程式時,請記住下列重點:

  • 如果您想要新增元件,並使用應用程式中已存在的相同本機唯一標識碼 (LUID) 覆寫元件,請指定 [覆寫] 選項。 如果未指定,且與所新增元件具有相同 LUID 的元件已存在於應用程式中,作業將會失敗。 LUID 包含元件檔名、版本、文化特性和公鑰令牌。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。

  • 如果您要新增的組件依賴於應用程式中未包含的另一個工件,則新增作業將會失敗。

  • 當您新增 BizTalk 元件時,您可以指定下列一或多個選項,將元件安裝至全域程式集緩存 (GAC):

    • 新增資源時,使用 gacutil 將其新增至全域組件快取。 當您選取此選項時,當元件被新增至應用程式時,元件會安裝在本機電腦上的 GAC 中,這是因為您使用了本主題中的程序。

    • 匯入 MSI 檔案時新增至全域組件快取(gacutil)。 當您選取此選項時,如果應用程式導出至 .msi 檔案,而且 .msi 檔案會匯入 BizTalk 群組,則元件會安裝在本機電腦上的 GAC 中,作為匯入程式的一部分。

    • 在 MSI 檔案安裝時新增至全域組件快取(gacutil)。 當您選取此選項時,如果應用程式匯出至 .msi 檔案,且應用程式會從 .msi 檔案安裝在計算機上,則元件會安裝在本機電腦上的 GAC 中,做為安裝程式的一部分。

先決條件

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

將 BizTalk 元件新增至應用程式

使用 BizTalk Server 管理控制台

  1. 依序按兩下 [開始]、[ 所有程式]、 [Microsoft BizTalk Server 20xx],然後按兩下 [ BizTalk Server 系統管理]。

  2. 在主控台樹中,展開 [BizTalk Server 系統管理],然後展開包含您要新增 BizTalk 組件的應用程式的 [BizTalk 群組]。

  3. 展開 [應用程式] 和您要新增 BizTalk 元件的應用程式。

  4. 以滑鼠右鍵按兩下 [資源],指向 [ 新增 ],然後按兩下 [ BizTalk 元件]。

  5. 按兩下 [新增],選取 BizTalk 元件檔案,然後按兩下 [ 開啟]。

  6. [目的地] 中,輸入從 .msi 檔案安裝應用程式時,要複製元件檔案之位置的完整路徑,包括檔名。 如果未提供,則元件檔案不會在安裝期間複製到本機文件系統。

  7. [選項] 中,指定將BizTalk元件安裝至 GAC 的選項,然後按兩下 [ 確定]。

使用命令列

  1. 開啟命令提示字元,如下所示:按兩下 [ 開始],按兩下 [ 執行],輸入 cmd,然後按兩下 [ 確定]。

  2. 輸入下列命令,取代適當的值,如下表所述:

    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 Assemblies\ 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 實例名稱,格式為 ServerName\InstanceName,Port。

    只有在實例名稱與伺服器名稱不同時,才需要實例名稱。 只有當 SQL Server 使用非預設的埠號碼(1433)時,才需要指定埠號。

    範例:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    如果未提供,則會使用本機計算機上執行的 SQL Server 實例名稱。
    /資料庫 BizTalk 管理資料庫的名稱。 如果未指定,則會使用在 SQL Server 本機實例中執行的 BizTalk 管理資料庫。

另請參閱

管理 BizTalk 元件
AddResource 命令:BizTalk 組件