AddResource 命令:BizTalk 組件
若要將 BizTalk 元件新增至 BizTalk 應用程式,您可以使用 AddResource 命令,並針對 Type 參數指定 System.BizTalk:BizTalkAssembly 。 執行此命令會將組件新增至 BizTalk 管理資料庫。 組件也會顯示於 BizTalk Server 管理主控台,列在加入該組件的應用程式的 [資源] 資料夾中。 包含在組件中的成品也會顯示在對應的資料夾裡。 此外,當您使用 ListApp 命令時,會列出成品。
當您使用此命令時,請記住下列重點:
如果應用程式中有任何組件,其完整名稱與所加入的組件相同,就必須指定 Overwrite 參數,否則 AddResource 作業將會失敗。 完整名稱是由名稱、公開金鑰 Token、文化特性和版本所組成。 然而,若是其他應用程式相依於該組件,則即使指定 Overwrite 參數,AddResource 作業也將失敗。
如果群組中的其他組件具有相同的完整名稱,則即使指定 Overwrite 參數,AddResource 作業也將失敗。
如果您要覆寫的組件含有協調流程,執行此命令前必須先停止並取消登錄協調流程。 此外,您也必須停止並取消登錄與協調流程繫結的傳送埠,同時停用接收位置。
如果您要加入的組件與未包含在此應用程式中的其他成品具有相依性,AddResource 作業將會失敗。
如需相依性的詳細資訊,請參閱 相依性和應用程式部署。
使用方式
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/Server:value] [/Database:value]
參數
參數 | 必要 | 值 |
---|---|---|
/ApplicationName (或 /A,請參閱) | No | 加入組件之 BizTalk 應用程式的名稱。 如果名稱包含空格,您必須將它括在雙引號 (") 中。 如果沒有指定應用程式名稱,將會使用預設的 BizTalk 應用程式。 |
/Type (或 /T,請參閱) | Yes | System.BizTalk:BizTalkAssembly (此值不區分大小寫。) |
/Overwrite (或 /Ov,請參閱備註) | No | 此選項指定更新現有的組件。 若未指定此選項,且應用程式中現有的組件與所加入的組件具有相同的完整名稱,AddResource 作業將會失敗。 完整名稱對應到組件的本機唯一識別碼 (LUID)。 您可以使用 ListApp 命令,檢視應用程式中成品的 LUID。 如果其他應用程式相依於即將覆寫的組件,則即使指定此參數,AddResource 作業也會失敗。 |
/Source (或 /So,請參閱) | Yes | 組件檔案的完整路徑 (包含檔案名稱)。 如果路徑包含空格,您必須將它括在雙引號 (") 中。 |
/Destination (或 /De,請參閱備註) | No | 從 .msi 檔案安裝應用程式時,組件檔案之複製目的位置的完整路徑。 如果不提供,安裝期間就不會將組件檔案複製到本機檔案系統。 如果路徑包含空格,您必須將它括在雙引號 (") 中。 注意:您可以使用BizTalk Server安裝期間設定的環境變數 %BTAD_InstallDir%,來指定應用程式安裝資料夾。 這樣就能在不同的目的地電腦上,為應用程式的檔案建立完全一致的存放位置。 範例:"%BTAD_InstallDir%\MyFiles\Orchestrations.dll" |
/Options (或 /Op,請參閱) | No | - GacOnAdd:指定在 AddResource 作業期間,將元件安裝到全域組件快取 (GAC) 。 - GacOnInstall:指定從 .msi 檔案安裝應用程式時,將元件安裝到 GAC。 - GacOnImport:指定在匯入應用程式 .msi 檔案時,將元件安裝到 GAC。 您必須以逗點分隔多個選項。 |
/Server (或 /Se,請參閱備註) | No | 裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱,其格式為:伺服器名稱\執行個體名稱,連接埠。 只有在執行個體名稱和伺服器名稱不同時,才需要執行個體名稱。 只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時,才需要連接埠。 範例: Server=MyServer Server=MyServer\MySQLServer,1533 如果不提供,將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。 |
/Database (或 /Da,請參閱) | No | BizTalk 管理資料庫的名稱。 如果沒有指定,將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。 |
樣本
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite
/Source:"%BTAD_InstallDir%\Source Assemblies\Orchestrations.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\Orchestrations.dll" /Options:GacOnInstall,GacOnImport /Server:MyDatabaseServer /Database:BizTalkMgmtDb
備註
參數不區分大小寫。 您不需要輸入整個參數名稱來指定它;您可以輸入參數名稱的前幾個字母,只要能明確識別就好了。