枚举接收位置(BizTalk Server 示例)

“枚举接收位置”示例演示了如何检索有关一个或多个接收位置的详细信息。

警告

部署后,如果不再需要部署脚本,则应将其删除。 应通过 ACL 确保必须保留的管理脚本和其他脚本的安全并加以密切监视。

本示例的用途

此示例包括访问 Windows WMI 对象模型的 Visual Basic Scripting Edition (VBScript) 版本,以及访问.NET Framework提供的 System.Management 对象的 Visual C# 版本。 上述两个版本最终会访问 BizTalk Server WMI 提供程序,以执行下列操作:

  • 在已知名称的情况下,查询配置的接收位置集或某一特定接收位置。

  • 检索和显示每个相关接收位置的有关详细信息。

  • 处理所有错误,以便向用户返回有意义的信息。

本示例所在的位置

本示例位于以下 SDK 位置:

  • VBScript 版本:<Samples Path>\管理员\WMI\Enumerate Receive Locations\VBScript\

  • Visual C# 版本:<Samples Path>\管理员\WMI\Enumerate Receive Locations\CSharp\

    下表显示了本示例中的文件及其用途说明:

文件 说明
\VBScript 文件夹的内容:

EnumRecLocs.vbs
用于检索有关配置的所有接收位置的详细信息的 VBScript 文件。
\CSharp 文件夹的内容:

App.ico、AssemblyInfo.cs、BTSampleEnumerateRLs.csproj、BTSampleEnumerateRLs.sln 和 EnumRLs.cs
用于生成 Visual C# 命令行应用程序的项目、解决方案和源文件,该应用程序检索有关配置的所有接收位置或某一特定接收位置的详细信息。

生成和初始化此示例

“枚举接收位置”示例的 VBScript 版本包括一个 Visual Basic 脚本文件,您无需生成或初始化该脚本文件。

生成“枚举接收位置”示例的 Visual C# 版本

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

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

运行本示例

运行“枚举接收位置”示例

  1. 在命令窗口中,导航至下列文件夹之一,具体哪一个文件夹取决于您是要运行本示例的 VBScript 版本还是 Visual C# 版本:

    <示例路径>\管理员\WMI\Enumerate Receive Locations\VBScript\

    <示例路径>\管理员\WMI\Enumerate Receive Locations\CSharp\bin\Debug\

  2. 使用 cscript 程序运行 EnumRecLocs.vbs 文件,或者运行 EnumRl.exe 文件,具体要运行哪一个文件取决于您是要运行本示例的 VBScript 版本还是 Visual C# 版本。 对于 Visual C# 版本,请传递下列两个命令行参数之一:

    • <ReceiveLocationName>。 将显示其详细信息的接收位置的名称。 如果接收位置名称包含空格,则将该名称置于引号中。

    • /?. 显示帮助。

      例如 (VBScript):

      cscript EnumRecLocs.vbs
      

      - 或者 - (Visual C#):

      EnumRl "My Receive Location #3"
      

      - 或者 - (Visual C#):

      EnumRl /?
      

    注意

    此示例的 VBScript 版本不接受任何命令行参数,因此只能检索和显示有关所有已配置接收位置的详细信息。

注释

还可以通过使用访问 Windows WMI 对象模型的脚本和访问.NET Framework提供的 System.Management 对象的 Visual C# 来执行可在 BizTalk Server 管理控制台中执行的所有任务。

脚本文件 EnumRecLocs.vbs 和 Visual C# 源文件 EnumRLs.cs 包含详细的注释,并进一步说明它们执行的操作。 有关详细信息,请参阅 Windows Management Instrumentation

另请参阅

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