注册编排(BizTalk Server 示例)

登记编排示例演示如何将 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# 版本

  1. 在 Visual Studio 中,打开解决方案文件BTSampleEnlistOrc.sln。

  2. “生成 ”菜单中,单击“ 生成解决方案”。

运行登记编排示例。

  1. 在命令窗口中,导航到以下文件夹之一,具体取决于是计划分别运行此示例的 VBScript 版本还是 Visual C# 版本:

    < 示例路径>\Admin\WMI\Enlist Orchestration\VBScript\

    < 示例路径>AdminWMIEnlist OrchestrationCSharpbinDebug

  2. 使用 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

另请参阅

Admin-WMI (BizTalk Server 示例文件夹)