如何新增前置或後置處理指令碼至應用程式

發行項
10/14/2023

本主題說明如何使用 BizTalk Server 管理主控台或命令列，將前置或後置處理指令碼新增至應用程式。當您將指令碼加入至應用程式時，指令碼會包含在應用程式 .msi 檔案中，並且會在匯入、安裝或解除安裝應用程式時執行。

加入指令碼時，您必須指定它是前置處理指令碼 (會在應用程式匯入或安裝啟動之前執行)，還是後置處理指令碼 (會在應用程式匯入或安裝完成之後執行)。前置和後置處理腳本也會在卸載時執行，與其在安裝時執行的相反順序：卸載後執行前置處理腳本，並在卸載前執行後處理腳本。

您也可以從應用程式移除指令碼。如需指示，請參閱如何從應用程式移除前置或後置處理腳本。

必要條件

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

若要新增指令碼至應用程式

使用 BizTalk Server 管理主控台

依序按一下 [開始]、[所有程式]、[Microsoft BizTalk Server 20xx]，然後按一下[BizTalk Server系統管理]。
依序展開 BizTalk 群組和 [應用程式]，然後以滑鼠右鍵按一下要新增指令碼之應用程式的資料夾。
指向 [新增]，然後執行下列其中一項：
- 如果您想要在應用程式匯入或安裝開始或卸載之前執行腳本，請按一下 [ 前置處理腳本 ]。
- 如果您想要在應用程式匯入或安裝之後，或在卸載之前執行腳本，請按一下 [後續處理腳本 ]。
按一下 [新增 ] 並流覽至要新增的腳本檔案。
選取腳本檔案，然後按一下 [ 開啟]。
如果您想要覆寫已存在於應用程式中的腳本檔案，請選取 [ 覆寫所有 ] 核取方塊。指令碼檔案必須與新增檔案同名，才會被覆寫。否則，加入新指令碼時，應用程式中的現有指令碼會維持不變。
按一下[檔案類型] 下拉式清單，然後按一下檔案類型 – System.BizTalk：PreprocessingScript 或 System.BizTalk：PostprocessingScript。
如有必要，在 [目的地位置 ] 中，輸入您要在安裝應用程式時複製腳本檔案的路徑，然後按一下 [ 確定]。預設路徑會將指令碼安裝到應用程式安裝資料夾 (%BTAD_InstallDir%)。

注意

如果您沒有提供這個路徑，在安裝時，就不會將指令碼複製到本機檔案系統。如果這個指令碼應該會在應用程式解除安裝時執行，請務必提供這個路徑；否則，指令碼不會出現在本機檔案系統中，並且無法在解除安裝期間執行。

指令碼隨即加入至應用程式，而且會顯示在應用程式的 [Resources] 資料夾中。

使用命令列

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

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

BTSTask AddResource [/ApplicationName：value] /Type：System.BizTalk：PreProcessingScript System.BizTalk：PostProcessingScript| [/Overwrite] /Source：value [/Destination：value] [/Server：value] [/Database：value][/Property：Args=「argument list」]

範例：

BTSTask AddResource /ApplicationName：MyApplication /Type：System.BizTalk：PreProcessingScript /Overwrite /Source：「C：\Source Scripts\MyScript.vbs」 /Destination：「C：\New Scripts\MyScript.vbs」 /Server：MyDatabaseServer /Database：BizTalkMgmtDb /Property：Args=「argument1 argument2」

參數	值
/ApplicationName	加入指令碼之 BizTalk 應用程式的名稱。如果沒有指定應用程式名稱，將會使用預設的 BizTalk 應用程式。如果名稱包含空格，您必須將它括在雙引號 (") 中。
/類型	System.BizTalk：PreProcessingScript 或 System.BizTalk：PostProcessingScript，視要新增的腳本類型而定。如果您想要在應用程式匯入或安裝之前或卸載之前執行腳本，請使用 System.BizTalk：PreProcessingScript 。如果您想要在應用程式匯入或安裝之後或卸載之前執行腳本，請使用 System.BizTalk：PostProcessingScript 。
/覆蓋	更新現有的指令碼。如果未指定此選項，而且應用程式中現有的指令碼檔案與所加入的指令碼檔案同名，加入作業將會失敗。
/源	指令碼檔案的完整路徑 (包含檔案名稱)。如果路徑包含空格，您必須將它括在雙引號 (") 中。
/目的地	從 MSI 檔案安裝應用程式時，指令碼檔案之複製目的位置的完整路徑。如果不提供，安裝期間就不會將檔案複製到本機檔案系統。如果路徑包含空格，您必須將它括在雙引號 (") 中。
/伺服器	裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱，其格式為：伺服器名稱\執行個體名稱,連接埠。只有在執行個體名稱和伺服器名稱不同時，才需要執行個體名稱。只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時，才需要連接埠。範例： Server=MyServer Server=MyServer\MySQLServer,1533 如果不提供，將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。
/資料庫	BizTalk 管理資料庫的名稱。如果沒有指定，將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。
/Property:Args=	零或多個引數。在此提供的引數會在叫用指令碼時傳入指令碼。

另請參閱

管理前置和後置處理指令碼
 AddResource 命令：前置處理指令碼
 AddResource 命令：後置處理指令碼

共用方式為