侦听器管理命令
为了支持新的 BAM 侦听器功能，在 BAM 管理实用程序中添加了四个新命令。
这些命令支持侦听器的部署、检索和删除。 还提供了一个命令用于列出已配置的侦听器。
deploy-interceptor：部署侦听器配置。
get-interceptorlist：获取部署拦截的活动列表。
get-interceptor：获取侦听器配置。
remove-interceptor：删除侦听器配置。
注意
可以通过包括 -Trace：on|off 参数开关在任何 BM 实用工具命令上启用跟踪。 使用 Trace 开关将重写配置文件中的跟踪设置。 该开关可与所有标准 BM 命令一起使用。
注意
在支持用户帐户控制 (UAC) 的系统上，可能需要具有管理权限才能运行该工具。
deploy-interceptor 命令
使用情况
bm.exe deploy-interceptor -FileName：<Configuration XML Filename> [-Force：True ] [-Server：<server>] [-Database：<database>]
参数
| 参数 | 说明 |
|---|---|
| FileName：<配置 XML 文件名> | 包含侦听器配置的 XML 文件的名称。 |
| Force:True | 可选：检测到事件源名称冲突时强制部署侦听器配置。 |
| Server：<server> | 可选：要部署侦听器的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 |
| Database：<database> | 可选：要配置侦听器的 BAM 主导入数据库的名称。 |
此命令将侦听器配置部署到指定的服务器和数据库。 在部署期间，BAM 管理实用程序执行以下验证：
XSD 验证：根据通用侦听器配置架构验证侦听器配置。
验证活动存在（部署在主导入数据库中）且检查点有效（存在并具有匹配的数据类型）。
如果在事件源名称中检测到冲突，则发出描述冲突的警告。 发生冲突时，除非使用 –Force：True 参数标志，否则部署将失败。
注意
–Force：True 参数可能会删除引用同名事件源的侦听器配置。 在使用 –Force：True 参数之前，应使用 get-interceptor 命令创建现有侦听器配置的备份。
示例
bm.exe deploy-interceptor -FileName:myInceptor.xml
bm.exe deploy-interceptor -FileName:myInceptor.xml -Force:True
get-interceptorlist 命令
使用情况
bm.exe get-interceptorlist [-Server：<server>] [-Database：<database>]
参数
| 参数 | 说明 |
|---|---|
| Server：<server> | 可选：要从中返回已部署侦听器列表的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 |
| Database：<database> | 可选：要从中检索已部署侦听器的 BAM 主导入数据库的名称。 |
此命令返回活动的列表及为之启用侦听的关联事件源。
示例
bm.exe get-interceptorlist
get-interceptor 命令
使用情况
bm.exe get-interceptor [-Server：<server>] [-Database：<database>] -FileName： <Configuration XML Filename> [ -Activity： <Activity Name>] [-EventSource： <Event Source Name>]
参数
| 参数 | 说明 |
|---|---|
| Server：<server> | 可选：要从中检索已部署侦听器的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 |
| Database：<database> | 可选：要从中检索已部署侦听器的 BAM 主导入数据库的名称。 |
| FileName：<配置 XML 文件名> | 向其写入侦听器配置的 XML 文件的名称。 |
| 活动：<活动名称> | 可选：指定要为其返回配置的侦听器的活动。 可与 EventSource 参数结合使用，以进一步指定要返回的配置。 |
| EventSource：<事件源名称> | 可选：指定要为其返回配置的侦听器的事件源。 可与 Activity 参数结合使用，以进一步指定要返回的配置。 |
如果没有提供活动名称或事件源名称，该命令将为所有事件源和活动返回包含侦听器配置的有效配置文件。
如果只提供活动名称，该命令将为该活动的所有事件源返回有效的侦听器配置文件。
如果只提供事件源名称，该命令将为所有活动中的该事件源返回有效的侦听器配置文件。
如果同时提供了活动名称和事件源名称，则该命令将为该活动的该事件源返回有效的侦听器配置文件。
示例
bm.exe get-interceptor
bm.exe get-interceptor -Activity:ShippingPO
remove-interceptor 命令
使用情况
bm.exe remove-interceptor [-Server：<server] [-Database：<database>] [ -Activity： <Activity Name>][-EventSource：Event Source： <Event Source Name>>]
参数
| 参数 | 说明 |
|---|---|
| Server：<server> | 可选：配置侦听器的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 |
| Database：<database> | 可选：配置侦听器的数据库的名称。 |
| 活动： <活动名称> | 可选：指定要删除其指定侦听器的活动。 可与 EventSource 参数结合使用，以进一步指定要返回的配置。 |
| EventSource： <事件源名称> | 可选：指定要删除其指定侦听器的事件源。 可与 Activity 参数结合使用，以进一步指定要返回的配置。 |
如果只提供活动名称，该命令将为该活动的所有事件源删除侦听器。
如果只提供事件源名称，该命令只删除所有活动的该事件源部分。
示例
bm.exe remove-interceptor