登錄協調流程 (BizTalk Server 範例)
「登錄協調流程」範例會示範如何向主控件登錄 BizTalk Server 協調流程。
警告
如果在部署後不需要部署指令碼，就應該將其移除。 必須保留的系統管理指令碼和其他指令碼都應該由 ACL 保護，而且予以密切監控。
此範例的用途
此範例包含 Visual Basic Scripting Edition (VBScript) 版本，可存取 Windows Management Instrumentation (WMI) 物件模型，以及存取 .NET Framework 所提供的System.Management物件的 Visual C# 版本。 這兩個版本最後都會存取 BizTalk Server WMI 提供者來執行下列作業：
在指定協調流程名稱和組件名稱的情形下，查詢已部署的特定 BizTalk Server 協調流程。
向預設主控件登錄該協調流程。
處理任何錯誤，讓有意義的資訊能傳回給使用者。
可在何處找到此範例
範例位於下列 SDK 位置：
VBScript 版本： <範例路徑> \管理員\WMI\Enlist Orchestration\VBScript\
Visusal C# 版本： <範例路徑> \管理員\WMI\Enlist Orchestration\CSharp\
下表顯示此範例中的檔案，並描述其用途。
| 檔案 | Description |
|---|---|
| 在 \VBScript 資料夾中： EnlistOrch.vbs |
VBScript 檔案，它會接受特定參數來指定要向主控件登錄的協調流程。 |
| 在 \CSharp 資料夾中： App.ico、AssemblyInfo.cs、BTSampleEnlistOrc.csproj、BTSampleEnlistOrc.sln、EnlistOrc.cs |
專案、方案和原始程式檔，用於建置 Visual C# 命令列應用程式，這個應用程式會接受特定參數來指定要向主控件登錄的協調流程。 |
建置和初始化此範例
VBScript 版的「登錄協調流程」範例是由單一 Visual Basic 指令碼檔案所組成，您不需要建置或初始化該檔案。
若要建置 Visual C# 版的登錄協調流程範例
在 Visual Studio 中，開啟方案檔案 BTSampleEnlistOrc.sln。
在 [ 建置 ] 功能表中，按一下 [ 建置方案]。
若要執行登錄協調流程範例
在命令視窗中，根據您打算執行此範例的 VBScript 版或 Visual C# 版，分別瀏覽至下列其中一個資料夾：
< 範例路徑>\管理員\WMI\Enlist Orchestration\VBScript\
< 範例路徑>AdminWMIEnlist OrchestrationCSharpbinDebug
根據您打算執行此範例的 VBScript 版或 Visual C# 版，分別使用 cscript 程式執行 EnlistOrch.vbs 檔，或是執行 EnlistOrc.exe 檔。 無論執行哪個版本，都會傳遞下列命令列引數：
< OrchestrationName> 。要登記的協調流程名稱。
< AssemblyName> 。部署協調流程的元件名稱。 如果組件名稱包含空格，請用引號括住該名稱。
例如： (VBScript) ：
cscript EnlistOrch.vbs MyBusinessOrchestration "My Business Assembly"-或- (Visual C#)：
EnlistOrc MyBusinessOrchestration "My Business Assembly"
註解
您可以在 BizTalk Server 管理主控台中執行的所有工作，也可以使用可存取 Windows WMI 物件模型的腳本，以及使用 Visual C# 存取.NET Framework所提供的System.Management物件來執行。
指令檔 EnlistOrch.vbs 和 Visual C# 來源檔 EnlistOrc.cs，包含了詳細註解，以及這兩個檔案所執行作業的相關進一步說明。 如需詳細資訊，請參閱 Windows Management Instrumentation。