向应用程序添加绑定文件

概述

使用 BizTalk Server 管理控制台或命令行将绑定文件添加到 BizTalk 应用程序。 你可能希望执行此操作以使应用程序或程序集部署更容易,如 绑定文件和应用程序部署中所述。

可以根据导出绑定中所述,将程序集、应用程序或组的 BizTalk 应用程序中的 绑定导出到 .xml 文件中,然后使用本主题中的某个过程将绑定文件添加到应用程序。

在您这样做了之后,该绑定文件将添加到 BizTalk 管理数据库并显示在 BizTalk Server 管理控制台的应用程序的“资源”文件夹中。 与导入绑定文件不同,添加绑定文件并不会立即应用其绑定。 而是在将应用程序导入到其他 BizTalk 组时应用绑定。

重要

为安全起见,在导出绑定时,BizTalk Server 会从该文件中删除绑定的密码。 在导入绑定后,必须为发送端口和接收位置重新配置密码,它们才能正常运行。 您需要在 BizTalk Server 管理控制台的“传输属性”对话框中为发送端口或接收位置配置密码。 请参阅 创建发送端口创建接收位置

注意

使用绑定文件时,应验证项目是否已绑定到正确的主机,以及信任级别是否合适。

在您将某一绑定文件添加到应用程序时,可以通过表示环境的字符串(例如“Test”或“Production”)为目标部署环境指定一个值。 您可以将任何字符串用于该值。 然后,在您导入应用程序时,可以通过提供已为其目标环境指定的值,选择要应用的绑定文件。 这样做了之后,将会从该绑定文件应用这些绑定。 应用程序中与该文件中的绑定同名的所有现有绑定都将被自动覆盖。

导入应用程序时,绑定按如下顺序应用。 由于绑定在导入过程中应用,所以已应用的绑定将被同名的新绑定所覆盖。 换言之,将应用的具有特定名称的最后一个绑定生效。

  1. 由 BizTalk Server 生成的、未通过绑定文件显式添加到应用程序但用户已经显式选择导出到应用程序 .msi 文件的应用程序绑定。

  2. 已经显式添加但尚未指定目标部署环境的绑定文件。 本组中的绑定可以按任何顺序应用。

  3. 已经显式添加并且具有与为导入应用程序而选的部署环境相匹配的关联目标部署环境的绑定。 本组中的绑定可以按任何顺序应用。

    有关导入应用程序和应用绑定的详细信息,请参阅 导入 BizTalk 应用程序

必备条件

使用属于 BizTalk Server 管理员组成员的帐户登录。 部署和管理 BizTalk 应用程序所需的权限 提供了更多详细信息。

使用 BizTalk 管理添加绑定文件

  1. 在“开始”菜单) 打开“BizTalk Server管理” (。

  2. 依次展开“BizTalk Server管理”、BizTalk 组、“应用程序”,然后右键单击要向其添加绑定文件的应用程序。

  3. 指向 “添加”,然后单击“ 资源”。

  4. 单击“ 添加”,选择要添加的文件,然后单击“ 打开”。

  5. 若要覆盖此应用程序中具有相同文件名的现有绑定文件,请选中“覆盖所有检查框。 如果存在同名的其他文件,并且您没有选中此复选框,则添加操作将失败。

  6. “文件类型” 下拉列表中,选择“ System.BizTalk:BizTalkBinding”。

  7. “目标环境”中,键入一个字符串来表示要应用此文件中的绑定的目标部署环境,例如“测试”,然后单击“ 确定”。

    重要

    如果您将此字段保留为空,则在应用程序导入时将始终应用此文件中的绑定。

    绑定文件将被添加,并且该文件将显示在应用程序的“资源”文件夹中。

使用命令行添加绑定文件

  1. 打开命令提示符 (“开始 ”菜单 > 输入 cmd> ,选择“ 命令提示符) ”。

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

    BTSTask AddResource [/ApplicationName:“value] /Type:System.BizTalk:BizTalkBinding [/Overwrite] /Source:value/Property:TargetEnvironment=“value [/Server:value] [/Database:value]

    例如:

    BTSTask AddResource /ApplicationName:"My Application" /Type:System.BizTalk:BizTalkBinding /Source:"C:\Binding Files\MyBinding.xml" /Property:TargetEnvironment="Production" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    参数
    /ApplicationName 绑定文件要添加到的 BizTalk 应用程序的名称。 如果未指定应用程序名称,则将使用默认 BizTalk 应用程序。 如果名称包含空格,则必须用双引号将其括起来 (“) 。
    /类型 System.BizTalk:BizTalkBinding (此值不区分大小写。)
    /覆盖 更新现有绑定文件的选项。 如果未指定,并且应用程序中已存在与要添加的文件具有相同文件名的绑定文件,则 AddResource 操作将失败。
    /源 绑定文件的完整路径,包含文件名。 如果路径包含空格,则必须用双引号将其括起来 (“) 。
    /Property:TargetEnvironment= 指定目标部署环境的字符串。 您可以使用任何字符串,如 Production。 示例: /Property:TargetEnvironment=“Production”

    如果未指定,则会自动应用默认值<>。 值区分大小写。 如果该值包含空格,则必须将其括在双引号 (") 中。 环境值的最大长度为 128 个字符。
    /服务器 BizTalk 管理数据库的宿主 SQL Server 实例的名称,格式为“服务器名称\实例名称,端口”。

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

    示例:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

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

另请参阅

管理 .NET 程序集、证书和其他资源
AddResource 命令:BizTalk 绑定
创建和修改 BizTalk 应用程序