本主題描述如何使用 BizTalk Server 管理控制台或命令列，將非 BizTalk 元件的 .NET 組件新增至 BizTalk 應用程式。 將 .NET 元件新增至應用程式時，請記住下列重點：
如果您想要覆寫應用程式中已經存在的元件，請指定 [覆寫] 選項。 只有在兩個元件具有相同 LUID 時，才需要覆寫選項。 如果未指定，且應用程式中已經有與新增元件相同的 LUID 的元件，則新增作業將會失敗。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。
當您新增 .NET 元件時，您可以指定下列一或多個選項，將元件安裝至全域程式集緩存 （GAC）：
新增資源時，使用 gacutil 將其新增至全域組件快取。 當您選取此選項時，當元件被新增至應用程式時，元件會安裝在本機電腦上的 GAC 中，這是因為您使用了本主題中的程序。
匯入 MSI 檔案時新增至全域組件快取（gacutil）。 當您選取此選項時，如果應用程式導出至 .msi 檔案，而且 .msi 檔案會匯入 BizTalk 群組，則元件會安裝在本機電腦上的 GAC 中，作為匯入程式的一部分。 當您的應用程式包含原則以及原則相依的元件時，請選取此選項。 您必須這樣做，因為當您匯入包含原則的應用程式時，原則所依賴的任何元件都必須存在於 GAC 中。
在 MSI 檔案安裝時新增至全域組件快取（gacutil）。 當您選取此選項時，如果應用程式匯出至 .msi 檔案，且應用程式會從 .msi 檔案安裝在計算機上，則元件會安裝在本機電腦上的 GAC 中，做為安裝程式的一部分。
使 COM 元件可見（regasm）。 當您選取此選項時，如果應用程式匯出至 .msi 檔案，且應用程式會從 .msi 檔案安裝在計算機上，則會在安裝程式期間，將 Managed COM 元件新增至本機電腦上的 Windows 登錄。 如果您指定此選項，您也必須在 [目的地] 中指定檔案的位置。
註冊服務元件（regsvcs）。 當您選取此選項時，如果應用程式匯出至 .msi 檔案，且應用程式會從 .msi 檔案安裝在計算機上，則會在安裝程式期間，將 Managed COM+ 元件新增至本機電腦上的 Windows 登錄。 如果您指定此選項，您也必須在 [目的地] 中指定檔案的位置。
先決條件
若要執行本主題中的程式，您必須使用 BizTalk Server Administrators 群組成員的帳戶登入。 如需許可權的詳細資訊，請參閱 部署和管理 BizTalk 應用程式所需的許可權。
將 .NET 元件新增至應用程式
使用 BizTalk Server 管理控制台
依序按兩下 [開始]、[ 所有程式]、 [Microsoft BizTalk Server 20xx]，然後按兩下 [ BizTalk Server 系統管理]。
在主控台樹中，依序展開 [BizTalk Server 系統管理]、[BizTalk] 群組、[ 應用程式]，然後展開您要新增 .NET 元件的應用程式。
以滑鼠右鍵按兩下 [資源] 資料夾，指向 [ 新增]，然後按兩下 [ 資源]。
按一下 新增，按一下元件，然後按一下 開啟。
在 [ 文件類型 ] 下拉式清單中，選取 [System.BizTalk：Assembly]。
在 [選項] 中，選取此元件的部署選項。
在 [目的地] 中，輸入從 .msi 檔案安裝應用程式時，要複製檔案之位置的完整路徑，包括檔名。 如果未提供此路徑，則不會在安裝期間將檔案複製到本機文件系統。 若要將檔案複製到應用程式安裝資料夾，您可以使用路徑中的 %BTAD_InstallDir% 環境變數，這會在安裝應用程式時接受應用程式安裝資料夾的值。 如此一來，當您指定目的地位置時，就不需要知道應用程式安裝資料夾的路徑。
範例： %BTADInstall_Dir%\Assemblies\Orchestrations.dll
點擊 相依性 索引標籤，並檢視此元件相依的工件。
如果此元件相依的成品不存在於此應用程式中，而且您想要新增它，請按兩下 [ 新增至應用程式]，流覽至成品，然後按兩下 [ 開啟]。
完成後，請按一下 [確定] 。
使用命令列
開啟命令提示字元，如下所示：按兩下 [ 開始]，按兩下 [ 執行]，輸入
cmd，然後按兩下 [ 確定]。輸入下列命令，取代適當的值，如下表所述。
BTSTask AddResource [/ApplicationName：value] /Type:System.BizTalk:Assembly [/Overwrite] /Source：value [/Destination：value] [/Options：GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server：value] [/Database：value]
範例：
BTSTask AddResource /ApplicationName：MyApplication /Type：System.BizTalk：Assembly /Overwrite /Source：“C:\Source Assemblies\MyAssembly.dll” /Destination：“%BTAD_InstallDir%\New Assemblies\MyAssembly.dll” /Options：GacOnAdd，RegasmOnInstall /Server：MyDatabaseServer /Database：BizTalkMgmtDb
參數 價值觀 /ApplicationName 要新增元件的 BizTalk 應用程式名稱。 如果未指定應用程式名稱，則會使用群組的預設 BizTalk 應用程式。 如果名稱包含空格，您必須以雙引弧括住它（）。 /類型 System.BizTalk：Assembly （此值不區分大小寫。） /改寫 更新現有元件的選項。 如果未指定，而且元件已存在於與新增元件相同的完整名稱的應用程式中，AddResource 作業會失敗。 完整名稱包含元件檔名、版本、文化特性和公鑰令牌。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。 /源 元件檔的完整路徑，包括檔名。 如果路徑包含空格，您必須以雙引弧括住它（）。 /目的地 從 .msi 檔案安裝應用程式時，要複製元件檔的位置完整路徑。 如果未提供，則元件檔案不會在安裝期間複製到本機文件系統。 如果路徑有空格，您必須以雙引弧括住它（）。 如果您指定 RegasmOnInstall 或 RegsvcsOnInstall 選項，您也必須指定 Destination。 注意： 您可以在路徑中使用 %BTAD_InstallDir% 環境變數。 安裝應用程式時，它會採用應用程式安裝資料夾的值。 如此一來，當您指定目的地位置時，就不需要知道應用程式安裝資料夾的路徑。 範例：%BTAD_InstallDir%\Assemblies\Orchestrations.dll /選項 - GacOnAdd：在 AddResource 作業期間，將元件安裝到本機電腦上的全域程式集緩存 （GAC）。
- GacOnInstall：從 .msi 檔案安裝應用程式時，將元件安裝到 GAC。
- GacOnImport：匯入應用程式 .msi 檔案時，將元件安裝至 GAC。
- RegasmOnInstall：在從 .msi 檔案安裝應用程式時，將受控 COM 元件新增至 Windows 登錄。 如果您指定此選項，也必須指定目的地。
- RegsvcsOnInstall：將 Managed COM+ 組件新增至 Windows 登錄，當應用程式從 .msi 檔案安裝時。 如果您指定此選項，也必須指定目的地。
您必須以逗號分隔多個選項。/伺服器 裝載 BizTalk 管理資料庫的 SQL Server 實例名稱，格式為 ServerName\InstanceName，Port。
只有在實例名稱與伺服器名稱不同時，才需要實例名稱。 只有當 SQL Server 使用非預設的埠號碼（1433）時，才需要指定埠號。
範例：
Server=MyServer
Server=MyServer\MySQLServer，1533
如果未提供，則會使用本機計算機上執行的 SQL Server 實例名稱。/資料庫 BizTalk 管理資料庫的名稱。 如果未指定，則會使用在 SQL Server 本機實例中執行的 BizTalk 管理資料庫。
另請參閱
管理 .NET 元件、憑證和其他資源
AddResource 命令：.NET 元件
建立和修改 BizTalk 應用程式