如何向应用程序添加 BAM 项目

本主题介绍如何使用 BizTalk Server 管理控制台或命令行向 BizTalk 应用程序添加 BAM 项目。 添加 BAM 定义文件不会部署 BAM 定义。 导入应用程序 .msi 文件时会部署 BAM 定义。

如果要覆盖应用程序中已有的 BAM 项目,请指定覆盖选项。 仅当现有 BAM 项目具有与要添加的项目相同的文件名时,才需要 overwrite 选项。 如果未指定,且应用程序中已存在与要添加的文件同名的 BAM 项目,则添加操作将失败。

必备条件

若要执行本主题中的过程,你必须使用作为 BizTalk Server Administrators 组的成员的帐户登录。 有关权限的详细信息,请参阅 部署和管理 BizTalk 应用程序所需的权限

向应用程序添加 BAM 项目

使用 BizTalk Server 管理控制台

  1. 依次单击 "开始"、"程序"、" Microsoft BizTalk Server 20xx" 和 " BizTalk Server 管理"。

  2. 在控制台树中,依次展开 "BizTalk Server 管理"、"BizTalk 组"、"应用程序",然后展开要向其添加 BAM 项目文件的应用程序。

  3. 右键单击 " resources " 文件夹,指向 " 添加",然后单击 " 资源"。

  4. 单击 " 添加",选择 BAM 项目的文件,然后单击 " 打开"。

  5. 在 " 文件类型 " 下拉列表中,选择 " system.web: BAM"。

  6. 在 " 目标" 中,键入从 .msi 文件中安装应用程序时要将项目文件复制到的位置的完整路径,包括文件名。 如果不提供此路径,则在安装过程中,该文件将不会被复制到本地文件系统,但在导入应用程序 .msi 文件时,会部署该文件。

    示例: C:\My Applications\MyBAMfile.xml

  7. 完成后,单击 “确定”

使用命令行

  1. 按如下所示打开命令提示符:单击 " 开始",再单击 " 运行",键入 cmd ,然后单击 "确定"

  2. 键入以下命令,替换相应的值,如下表中所述:

    BTSTask AddResource [/ApplicationName:value] /type: system.web: Bam [/Overwrite] /source:value [/Destination:value] [/server:value] [/Database:value]

    示例:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Bam /Overwrite /Source:"C:\Source BAMfiles\MyBAMfile.xml" /Destination:"%BTADInstallDir%\ BAMfiles\MyBAMfile.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    参数
    /ApplicationName 向其添加 BAM 项目的 BizTalk 应用程序的名称。 如果未指定应用程序名称,则使用组的默认 BizTalk 应用程序。 如果名称包含空格,则必须将其括在双引号中 ( ") 。
    /Type System.web: Bam (此值不区分大小写。 )
    /Overwrite 覆盖现有 BAM 项目的选项。 如果不指定,且应用程序中已存在与要添加的 BAM 项目同名的 BAM 项目,则 AddResource 操作将失败。
    /Source BAM 项目文件的完整路径,包含文件名。 如果路径包含空格,则必须将其括在双引号中 ( ") 。
    /Destination 从 .msi 文件安装应用程序时,BAM 项目文件要复制到的位置的完整路径。 如果未提供,则在安装过程中不会将文件复制到本地文件系统。 如果路径包含空格,则必须将其括在双引号中 ( ") 。 您可以在路径中使用环境变量 %BTADInstallDir% 来指定应用程序安装文件夹。
    /Server BizTalk 管理数据库的宿主 SQL Server 实例的名称,格式为“服务器名称\实例名称,端口”。

    只在实例名称与服务器名称不相同时才需要指定实例名称。 只在 SQL Server 不使用默认端口号 (1433) 时才需要指定端口。

    示例:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    如果未提供,则使用本地计算机上运行的 SQL Server 实例的名称。
    /Database BizTalk 管理数据库的名称。 如果未指定,则使用在本地 SQL Server 实例中运行的 BizTalk 管理数据库。

另请参阅

管理 .NET 程序集、证书和其他资源
AddResource 命令:BAM 项目
创建和修改 BizTalk 应用程序
如何导入 BizTalk 应用程序