枚举接收位置示例演示如何检索有关一个或多个接收位置的详细信息。
警告
如果不需要，应在部署后删除部署脚本。 管理脚本和其他必须保留的脚本应由 ACL 保护并受到密切监视。
此示例的作用
此示例包括访问 Windows WMI 对象模型的 Visual Basic 脚本版本（VBScript）版本，以及访问 .NET Framework 提供的 System.Management 对象的 Visual C# 版本。 这两个版本最终都访问 BizTalk Server WMI 提供程序来执行以下操作：
根据其名称查询配置的接收位置集或特定的接收位置。
检索和显示有关每个感兴趣的接收位置的详细信息。
处理任何错误，以便向用户返回有意义的信息。
在何处查找此示例
这些示例位于以下 SDK 位置：
VBScript 版本： <示例路径>\Admin\WMI\Enumerate Receive Locations\VBScript\
Visual C# 版本： <示例路径>\Admin\WMI\Enumerate Receive Locations\CSharp\
下表显示了此示例中的文件，并描述了它们的用途。
| 文件 | DESCRIPTION |
|---|---|
| 在 \VBScript 文件夹中： EnumRecLocs.vbs |
检索所有已配置接收位置的详细信息的 VBScript 文件。 |
| 在 \CSharp 文件夹中： App.ico、AssemblyInfo.cs、BTSampleEnumerateRLs.csproj、BTSampleEnumerateRLs.sln、EnumRLs.cs |
用于生成 Visual C# 命令行应用程序的项目、解决方案和源文件，用于检索有关所有已配置接收位置或特定接收位置的详细信息。 |
生成和初始化此示例
枚举接收位置示例的 VBScript 版本包含一个不需要生成或初始化的 Visual Basic 脚本文件。
生成枚举接收位置示例的 Visual C# 版本
在 Visual Studio 中，打开解决方案文件BTSampleEnumerateRLs.sln。
在 “生成 ”菜单中，单击“ 生成解决方案”。
运行此示例
运行“枚举接收位置”示例程序
在命令窗口中，导航到以下文件夹之一，具体取决于是要分别运行此示例的 VBScript 版本还是 Visual C# 版本：
< 示例路径>\Admin\WMI\Enumerate Receive Locations\VBScript\
< 示例路径>\Admin\WMI\Enumerate Receive Locations\CSharp\bin\Debug\
使用 cscript 程序运行文件 EnumRecLocs.vbs，或运行文件 EnumRl.exe，具体取决于是要分别运行此示例的 VBScript 版本还是 Visual C# 版本。 对于 Visual C# 版本，请传递以下两个命令行参数之一：
<ReceiveLocationName>。 将显示详细信息的接收位置的名称。 如果接收位置名称包含空格，请将名称括在引号中。
/?. 显示帮助。
例如（VBScript）：
cscript EnumRecLocs.vbs-OR- （Visual C#）：
EnumRl "My Receive Location #3"OR（Visual C#）：
EnumRl /?
注释
此示例的 VBScript 版本不接受任何命令行参数，因此只能检索和显示所有已配置接收位置的详细信息。
注释
在 BizTalk Server 管理控制台中执行的所有任务，也可以通过使用访问 Windows WMI 对象模型的脚本，以及通过使用访问 .NET Framework 提供的 System.Management 对象的 Visual C# 来执行。
脚本文件 EnumRecLocs.vbs 和 Visual C# 源文件EnumRLs.cs包含详细注释，并详细说明了它们执行的作。 有关详细信息，请参阅 Windows Management Instrumentation。