範本 (應用程式部署範例)
本主題描述如何使用「範本」範例進行應用程式部署。
您可以建立和使用兩種類型的部署腳本來自訂 BizTalk 應用程式部署：前置處理腳本和後續處理腳本。 前置處理指令碼的叫用時機為應用程式安裝及匯入開始前，以及完成解除安裝之後。 後置處理指令碼的叫用時機則為應用程式安裝及匯入完成後，以及解除安裝開始之前。
您可以撰寫前置及後置處理指令碼，讓上述每項作業都能叫用這些指令碼。 或者，您也可以設定指令碼，使其只在上述某項作業後執行。 如需撰寫腳本的詳細資訊，請參閱 使用前置和後置處理腳本來自訂應用程式部署。
本主題將示範如何撰寫和部署指令碼，以便只在某項作業之前或之後叫用此指令碼。 若要這麼做，您可以撰寫指令碼來檢查三個環境 (Environment) 變數的值，判斷指令碼是在哪項作業的環境 (Context) 中受到呼叫。 指令碼會根據此環境 (Context) 繼續執行或中止執行。
本主題描述如何採取下列步驟：
設定記錄檔位置，以便產生指令檔作業的記錄檔。
注意
您應該採用的最佳作法是一律產生記錄檔，如此就能驗證指令檔作業以及對問題進行疑難排解。
建立新的 BizTalk 應用程式，並且在其中加入範例指令碼。
匯出包含應用程式成品的 .msi 檔案。
從 BizTalk 群組刪除應用程式，如此您就可以將 .msi 檔案匯入回相同群組，並從 .msi 檔案安裝應用程式。
匯入應用程式，並檢查記錄檔，查看是否記錄了匯入作業。
安裝應用程式，並檢查記錄檔，查看安裝記錄是否附加到記錄檔中。
檢視記錄檔，注意指令碼執行了哪些作業，以及作業的執行時間。
此範例的用途
本範例提供的兩個 .bat 檔案包含匯入、安裝和解除安裝的環境 (Environment) 變數值。 SamplePreProcessing.bat 包含前置處理指令碼的變數。 SamplePostProcessing.bat 包含後置處理指令碼的變數。 這兩個檔案也會示範如何記錄指令碼的訊息。 您可以將這些檔案中的相關區段複製到您的指令碼中。
重要
指令碼檔案中的部分註解不正確，如下所示：
SamplePreProcessing.bat 中的指令碼註解 "Pre uninstall part of the script called for an existing application" (為現有應用程式呼叫之指令碼的前置解除安裝部分) 應該是 "Post uninstall part of the script called for an existing application" (為現有應用程式呼叫之指令碼的後置解除安裝部分)。
SamplePostProcessing.bat 中的指令碼註解 "Post uninstall part of the script called for an existing application" (為現有應用程式呼叫之指令碼的後置解除安裝部分) 應該是 "Pre uninstall part of the script called for an existing application" (為現有應用程式呼叫之指令碼的前置解除安裝部分)。
可在何處找到此範例
此範例位於 BizTalk Server 安裝資料夾中，如下所示：
< 範例路徑 >\應用程式部署\範本
如前所述，此範例包含下列兩個檔案：
SamplePreProcessing.bat
SamplePostProcessing.bat
如何使用此範例
若要執行範例，請採取下列步驟。
若要設定記錄位置
開啟這兩個指令碼範例，變更 LogFile 變數，讓其指向要寫入記錄檔的位置。 您必須提供完整路徑，包含檔案名稱。 如果路徑包含空格，您必須將它括在雙引號 (") 中。
範例：
set LogFile=「< Samples Path >\ApplicationDeployment\Templates\SampleLogOut.txt」
若要建立新的應用程式
依序按一下 [開始]、[所有程式]、[Microsoft BizTalk Server 20xx]，然後按一下[BizTalk Server系統管理]。
在主控台樹狀目錄中，展開 [BizTalk Server 管理]，然後展開 BizTalk 群組。
以滑鼠右鍵按一下 [應用程式 ]，然後按一下 [ 新增]。
在 [應用程式名稱]中，輸入
SamplesTemplate，然後按一下 [ 確定]。
若要將指令碼加入至應用程式
展開您剛才建立的 SamplesTemplate 應用程式資料夾，然後在左窗格中的 [ 資源 ] 上按一下滑鼠右鍵。
指向 [ 新增 ]，然後按一下 [前置處理腳本]。
按一下 [新增 ] 並流覽至 [SamplePreProcessing.bat]。
選取檔案，然後按一下 [開啟]。
在 [檔案類型] 中，按一下 [System.BizTalk：PreprocessingScript]，然後按一下 [ 確定]。
SamplePreProcessing.bat 隨即加入至應用程式，而且會顯示在應用程式的 Resources 資料夾中。
再次以滑鼠右鍵按一下 [資源]，指向 [ 新增]，然後按一下 [後續處理腳本]。
按一下 [新增 ] 並流覽至 [SamplePostProcessing.bat]。
選取檔案，然後按一下 [開啟]。
在 [檔案類型] 中，按一下 [System.BizTalk：PostprocessingScript]，然後按一下 [ 確定]。
SamplePostProcessing.bat 隨即加入至應用程式，而且會顯示在應用程式的 Resources 資料夾中。
若要匯出 .msi 檔案
在 BizTalk Server 管理主控台中，以滑鼠右鍵按一下 SamplesTemplate 應用程式，指向 [匯出]，然後按一下[MSI 檔案]。
在 [歡迎使用匯出精靈] 頁面上，按 [下一步]。
在 [選取資源] 頁面上，按 [下一步]。
在 [指定 IIS 主機] 頁面上，按 [下一步]。
在 [相依性] 頁面上，按 [下一步]。
在 [目的地] 頁面上的 [ 目的地應用程式名稱] 中，輸入應用程式名稱。
在 要產生的 MSI 檔案中，輸入 MSI 檔案的完整路徑，然後按一下 [ 匯出]。 範例：C:\MSI\SamplesTemplate.msi
在 [摘要] 頁面中按一下 [ 完成]。
刪除應用程式
- 在 BizTalk Server 管理主控台中，以滑鼠右鍵按一下 SamplesTemplate 應用程式，然後按一下 [刪除]。
若要匯入 .msi 檔案
在 [BizTalk Server管理主控台] 中，以滑鼠右鍵按一下 [應用程式]，指向 [匯入]，然後按一下[MSI 檔案]。
在 [歡迎使用匯入精靈] 頁面上的 MSI 檔案中，輸入您先前匯出之 .msi 檔案的路徑，然後按 [ 下一步]。 如有必要，您可以按一下 [ (...) ] 按鈕來流覽 MSI 檔案。
在 [應用程式設定] 頁面上的 [ 應用程式名稱 ] 下拉式清單中，選取應用程式名稱。
在 [可用的應用程式] 中，選取要新增參考的應用程式，如果有的話，然後按 [ 下一步]。
在 [應用程式目標環境設定] 頁面上，按 [下一步]。
注意
您不必為此範例指定目標環境 (Environment)。 如需此功能的背景資訊，請參閱 系結檔案和應用程式部署。 如需新增系結檔案的指示，請參閱 如何將系結檔案新增至應用程式。
在 [匯入摘要] 頁面上，確認摘要資訊正確無誤，然後按一下 [ 匯入]。
在 [結果] 頁面上，按一下 [ 完成]。
開啟在執行指令檔時所建立的記錄檔，確認是否記錄了匯入作業。
若要安裝應用程式
按兩下 .msi 檔案並執行「安裝精靈」。
開啟記錄檔，確認安裝作業已加入至記錄資訊。
若要確認指令檔可正常運作
- 開啟記錄檔，確認在指定的作業期間指令檔都有執行。