共用方式為


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

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

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

  • 如果您想要覆寫應用程式中已存在的 COM 元件,請指定 [覆寫] 選項。 只有當這兩個工件具有相同的本機唯一標識碼 (LUID) 時,才需要覆寫選項。 如果未指定,且 COM 元件已存在於與新增的 LUID 相同的應用程式中,則新增作業將會失敗。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。

  • BizTalk Server 不會檢查 COM 元件的相依性來確認它們是否存在,因此您應該確認依賴於元件的任何工件是否已存在。

  • 如果您新增 64 位元未受控 COM 或 COM+ 元件,並嘗試在 32 位元電腦上安裝包含該 COM 或 COM+ 元件的應用程式,該元件將不會被安裝。 它只會安裝在64位電腦上。

先決條件

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

將 COM 元件新增至應用程式

使用 BizTalk Server 管理控制台

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

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

  3. 以滑鼠右鍵按兩下 [資源] 資料夾,指向 [ 新增],然後按兩下 [ 資源]。

  4. 按兩下 [新增],選取 COM元件,然後按兩下 [ 開啟]。

  5. 在 [ 文件類型 ] 下拉式清單中,按兩下 [System.BizTalk:Com]。

  6. [選項] 中,根據安裝應用程式時是否要將元件註冊至 Windows 登錄 (regsvr32),選取或清除 [在目的地註冊檔案] 複選框。

  7. [目的地] 中,輸入從 .msi 檔案安裝應用程式時,要複製 COM 元件之位置的完整路徑,包括檔名。 如果未提供此路徑,則不會在安裝期間將檔案複製到本機文件系統。 如果您在上一個步驟中選取了 [在目的地註冊檔案 (regsvr32)] 複選框,則需要此路徑。

    範例: %BTAD_InstallDir%\MyComponent.dll

  8. 完成後,請按一下 [確定]

使用命令列

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

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

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Com [/Overwrite] /Source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]

    範例:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:com /Overwrite /Source:“C:\Source Components\COM.dll” /Destination:“C:\New Components\COM.dll” /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    參數 價值觀
    /ApplicationName 要新增 COM 元件的 BizTalk 應用程式名稱。 如果未指定應用程式名稱,則會使用群組的預設 BizTalk 應用程式。 如果名稱包含空格,您必須以雙引弧括住它()。
    /類型 System.BizTalk:Com (此值不區分大小寫。)
    /改寫 更新現有 COM 元件的選項。 如果未指定,且 COM 元件已存在於與新增 COM 元件相同的 LUID 的應用程式中,AddResource 作業會失敗。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。
    /源 COM 元件 .dll 檔案的完整路徑,包括檔名。 如果路徑包含空格,您必須以雙引弧括住它()。
    /目的地 從 .msi 檔案安裝應用程式時,要複製 COM 元件 .dll 檔案位置的完整路徑。 如果未提供,則不會在安裝期間將檔案複製到本機文件系統;因此,元件無法在安裝期間新增至 Windows 登錄。 如果路徑包含空格,您必須以雙引弧括住它()。 如果您指定 Regsvr32OnInstallOption,您也必須指定 Destination。
    /選項 Regsvr32OnInstall。 指定 從 .msi 檔案安裝應用程式時,將 COM 元件新增至 Windows 登錄。 如果您指定此選項,也必須指定目的地。
    /伺服器 裝載 BizTalk 管理資料庫的 SQL Server 實例名稱,格式為 ServerName\InstanceName,Port。

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

    範例:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

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

另請參閱

管理 .NET 元件、憑證和其他資源
AddResource 命令:COM 元件
建立和修改 BizTalk 應用程式