共用方式為


如何將前置或後置處理腳本新增至應用程式

本主題描述如何使用 BizTalk Server 管理控制台或命令行,將前置或後置處理腳本新增至應用程式。 當您將腳本新增至應用程式時,腳本會包含在應用程式 .msi 檔案中,並在應用程式匯入、安裝或卸載時執行。

當您新增文稿時,您必須指定它是否為前置處理腳本,它會在應用程式匯入或安裝啟動之前執行,或後續處理腳本,這會在應用程式匯入或安裝完成之後執行。 前置和後置處理腳本也會在卸載時執行,與其在安裝時執行的順序相反:卸載後執行的前置處理腳本,並在卸載之前執行後處理腳本。

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

先決條件

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

將腳本新增至應用程式

使用 BizTalk Server 管理控制台

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

  2. 展開 BizTalk 群組,展開 [應用程式],然後以滑鼠右鍵按下您要新增腳本的應用程式資料夾。

  3. 指向 [新增],然後執行下列其中一項:

    • 如果您想要在應用程式匯入或安裝開始之前或卸載之後執行腳本,請按兩下 [前置處理腳本 ]。

    • 如果您想要在應用程式匯入或安裝之後或卸載之前執行腳本,請按兩下 [後續處理腳本 ]。

  4. 按兩下 [新增 ] 並瀏覽至要新增的腳本檔案。

  5. 選取腳本檔案,然後按兩下 [ 開啟]。

  6. 如果您想要覆寫應用程式中已存在的腳本檔案,請選取 [ 覆寫所有 ] 複選框。 腳本檔案必須與要覆寫的檔案同名。 否則會新增新的腳本,而且現有的腳本會保持不變。

  7. 按一下 [文件類型] 下拉式清單,然後選取檔案類型 – System.BizTalk:PreprocessingScriptSystem.BizTalk:PostprocessingScript

  8. 如有必要,在 [目的地位置 ] 中,輸入您要在安裝應用程式時複製腳本檔案的路徑,然後按兩下 [ 確定]。 預設路徑會將文稿安裝到應用程式安裝資料夾 (%BTAD_InstallDir%)。

備註

如果您未提供此路徑,腳本將不會在安裝時複製到本機文件系統。 如果腳本應該在卸載應用程式時執行,請務必提供此路徑;否則腳本不會存在於本機文件系統上,也不會在卸載期間執行。

腳本會新增至應用程式,並顯示在應用程式的 Resources 資料夾中。

使用命令列

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

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

    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:PreProcessingScriptSystem.BizTalk:PostProcessingScript,視要新增的腳本類型而定。 如果您想要在應用程式匯入或安裝之前或卸載之前執行腳本,請使用 System.BizTalk:PreProcessingScript 。 如果您想要在應用程式匯入或安裝之後或卸載之前執行腳本,請使用 System.BizTalk:PostProcessingScript
    /改寫 更新現有的腳本。 如果未指定,且腳本檔案已存在於與新增腳本檔案相同的應用程式中,則新增作業將會失敗。
    /源 腳本檔案的完整路徑,包括檔名。 如果路徑包含空格,您必須以雙引弧括住它()。
    /目的地 從 MSI 檔案安裝應用程式時,要複製腳本檔案之位置的完整路徑。 如果未提供,則不會在安裝期間將檔案複製到本機文件系統。 如果路徑包含空格,您必須以雙引弧括住它()。
    /伺服器 裝載 BizTalk 管理資料庫的 SQL Server 實例名稱,格式為 ServerName\InstanceName,Port。

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

    範例:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    如果未提供,則會使用本機計算機上執行的 SQL Server 實例名稱。
    /資料庫 BizTalk 管理資料庫的名稱。 如果未指定,則會使用在 SQL Server 本機實例中執行的 BizTalk 管理資料庫。
    /Property:Args= 零或多個參數。 此處提供的參數會在叫用腳本時傳遞至腳本。

另請參閱

管理前置和後置處理腳本
AddResource 命令:前置處理腳本
AddResource 命令:後續處理腳本