基础结构管理命令

通过 BAM 管理 (BM) 实用程序命令,可以获取和更新 BAM 配置。

  • get-config:获取 BAM 配置文件。

  • update-config:汇报 BAM 配置。

  • get-changes:列出对 BAM 基础结构的更改。

  • get-defxml:获取包含 BAM 主导入数据库中所有项目的文件。

注意

可以通过包括 -Trace:on|off 参数开关,对任何 BM 实用工具命令启用跟踪。 使用 Trace 开关将重写配置文件中的跟踪设置。 该开关可与所有标准 BM 命令一起使用。

注意

在支持用户帐户控制 (UAC) 的系统上,可能需要具有管理权限才能运行该工具。

get-config 命令

使用情况

bm.exe get-config -FileName:<output file> [ -Server:<server> ][ -Database:<database> ]

参数

参数 说明
FileName:<output file> 保存配置的文件的路径和名称。
Server:<server> 可选:要从中获取配置的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 如果未指定服务器名称,bm.exe 将使用 localhost 的默认名称。
Database:<database> 可选:要从中获取配置的数据库的名称。 如果未指定该名称,则 bm.exe 将使用默认名称 BamPrimaryImport。

检索 BAM 配置 XML,并将其保存到指定的文件中。 get-config 命令不会覆盖现有文件。

示例

bm.exe get-config -FileName:MyConfig.xml  
bm.exe get-config -FileName:BAMConfiguration.xml -Server:OrdersServer  

update-config 命令

使用情况

bm.exe update-config -FileName:<config file>

参数

参数 说明
FileName:<config file> 更新 BAM 基础结构所用配置文件的路径和名称。

更新本地计算机上包含 BAM 配置 XML 文件中的配置。 可以添加当前配置中尚不存在的服务器名和数据库名。 如果已在服务器或数据库中部署了动态基础结构,则更改服务器名或数据库名将失败,并且 bm.exe 会报告错误。

如果修改了送达的警报的文件存放位置, 则必须重新启动 SQL Notification Services。 如果没有重新启动 NS 服务,则警报将继续传送到原始的文件存放位置。

修改 BAM 配置文件的以下行,可以更改文件存放位置。

<Property Name=“FileDropUNC”>\\<computer name>\alerts</Property>

有关更新引用的适当步骤,请参阅备份和还原BizTalk Server

重要

如果执行 update-database 命令时使用不包含警报部分的 BAM 配置文件,但是已经配置了 BAM 警报,则 bm.exe 将覆盖该配置,因而这些警报就不再起作用。

示例

bm.exe update-config -FileName:MyConfig.xml  

get-changes 命令

使用情况

bm.exe get-changes [ -Server:<server> ][ -Database:<database> ]

参数

参数 说明
Server:<server> 可选:BAM 主导入数据库所在的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 如果未指定服务器名称,bm.exe 将使用 localhost 的默认名称。
Database:<database> 可选:如果未指定名称,bm.exe 使用默认名称 BamPrimaryImport。

获取应用于 BAM 主导入数据库的一系列更改。 使用此命令可以审核对 BAM 基础结构所做的更改。 该命令将返回以下信息:

更改的命令类型以及应用更改所依据的文件。

谁应用了更改。

更改了哪些活动。

更改了哪些视图。

示例

bm.exe get-changes  

命令输出

#1:部署 c:\bam\ordermanagement.xml

By domain\user at 12/30/2005 8:17:08 PM (v3.5.1536.0).

活动:OrderMgmt

视图:SalesManager

get-defxml 命令

使用情况

bm.exe get-defxml -FileName:<output file>[ -Server:<server> ][ -Database:<database> ]

参数

参数 说明
FileName:<output file> 保存定义的文件的路径和名称。
Server:<server> 可选:要从中获取定义的服务器的名称。 服务器必须与运行 bm.exe 的计算机位于同一域中。 如果未指定服务器名称,bm.exe 将使用 localhost 的默认名称。
Database:<database> 可选:要从中获取定义的数据库的名称。 如果未指定该名称,则 bm.exe 将使用默认名称 BamPrimaryImport。

从 BAM 主导入数据库检索所有项目,并将这些项目保存到一个 XML 格式的文件中。 此命令不会覆盖现有文件。

示例

bm.exe get-defxml -FileName:BAMDefinition.xml  
bm.exe get-defxml -FileName:MyDef.xml -Server:MyServer -Database:MyPI  

另请参阅

BAM 管理实用工具