登记编排示例演示如何将 BizTalk Server 编排加入到主机。
警告
如果不需要,应在部署后删除部署脚本。 管理脚本和其他必须保留的脚本应由 ACL 保护并受到密切监视。
此示例的作用
此示例包括访问 Windows Management Instrumentation (WMI) 对象模型的 Visual Basic 脚本版本(VBScript)版本,以及访问 .NET Framework 提供的 System.Management 对象的 Visual C# 版本。 这两个版本最终都访问 BizTalk Server WMI 提供程序来执行以下操作:
给定业务流程名称和程序集名称,请查询特定部署的 BizTalk Server 业务流程。
将编排登记到默认主机。
处理任何错误,以便向用户返回有意义的信息。
在何处查找此示例
这些示例位于以下 SDK 位置:
VBScript 版本:<示例路径>\Admin\WMI\Enlist Orchestration\VBScript\
Visusal C# 版本: <Samples Path>\Admin\WMI\Enlist Orchestration\CSharp\
下表显示了此示例中的文件,并描述了它们的用途。
文件 | DESCRIPTION |
---|---|
在 \VBScript 文件夹中: EnlistOrch.vbs |
使用参数以指定要登记到主机的编排的 VBScript 文件。 |
在 \CSharp 文件夹中: App.ico、AssemblyInfo.cs、BTSampleEnlistOrc.csproj、BTSampleEnlistOrc.sln、EnlistOrc.cs |
用于构建 Visual C# 命令行应用程序的项目、解决方案和源文件,该应用程序通过参数指定要注册到主机的编排。 |
生成和初始化此示例
Enlist Orchestration 示例的 VBScript 版本包含一个不需要生成或初始化的 Visual Basic 脚本文件。
构建登记编排示例的 Visual C# 版本
在 Visual Studio 中,打开解决方案文件BTSampleEnlistOrc.sln。
在 “生成 ”菜单中,单击“ 生成解决方案”。
运行登记编排示例。
在命令窗口中,导航到以下文件夹之一,具体取决于是计划分别运行此示例的 VBScript 版本还是 Visual C# 版本:
< 示例路径>\Admin\WMI\Enlist Orchestration\VBScript\
< 示例路径>AdminWMIEnlist OrchestrationCSharpbinDebug
使用 cscript 程序运行文件 EnlistOrch.vbs,或运行文件 EnlistOrc.exe,具体取决于是计划分别运行此示例的 VBScript 版本还是 Visual C# 版本。 在任何情况下,传递以下命令行参数:
< OrchestrationName>。 要登记的业务流程的名称。
< AssemblyName>。 在其中部署业务流程的程序集的名称。 如果程序集名称包含空格,请将名称括在引号中。
例如:(VBScript):
cscript EnlistOrch.vbs MyBusinessOrchestration "My Business Assembly"
-OR- (Visual C#):
EnlistOrc MyBusinessOrchestration "My Business Assembly"
注释
在 BizTalk Server 管理控制台中执行的所有任务,也可以通过使用访问 Windows WMI 对象模型的脚本,以及通过使用访问 .NET Framework 提供的 System.Management 对象的 Visual C# 来执行。
脚本文件 EnlistOrch.vbs 和 Visual C# 源文件EnlistOrc.cs包含详细注释,并详细说明了它们执行的作。 有关详细信息,请参阅 Windows Management Instrumentation。