AddResource 命令：BizTalk 绑定

  • 项目

若要将绑定文件添加到 BizTalk 应用程序，请使用 AddResource 命令并为 Type 参数指定 System.BizTalk：BizTalkBinding。 添加绑定文件时，可以为其指定部署环境。 以后导入该应用程序时，可以选择此部署环境来应用这些绑定。 可以将任意数量的绑定文件添加到 BizTalk 应用程序中，每个绑定文件为不同的部署环境而定制。 通过为要添加的每个绑定文件运行此命令，可以添加多个文件。

可以添加为程序集、应用程序或组导出的绑定文件，如 ExportBindings 命令中所述，然后使用 AddResource 命令将该绑定文件添加到应用程序。

运行此命令可将绑定文件添加到 BizTalk 管理数据库中，该文件显示在应用程序的“资源”文件夹下。 此外，使用 ListApp 命令时会列出该文件。 与导入绑定文件不同，添加绑定文件并不会立即更改现有绑定。 在该应用程序导入到另一个 BizTalk 组后，才应用这些绑定。

添加绑定文件时，可以使用可选的 "TargetEnvironment" /Property 参数来指定其部署环境。 该值可以是表示要将此文件中的绑定应用到的部署环境的任何字符串，如 Test 或 Production。 如果未为 /Property 参数指定值，则会自动指定默认值<>，并且每次导入应用程序时都将应用此绑定文件。

如果要导入的应用程序中包含一个或多个以这种方式明确添加的绑定文件，则可以通过指定 /Property 参数的值，选择要应用哪个或哪些绑定文件。 在导入应用程序时应用绑定。

由于绑定在导入过程中应用，所以已应用的绑定将被同名的新绑定所覆盖。 换言之，将应用的具有特定名称的最后一个绑定生效。 使用多个绑定文件时，请注意这一情况。 如果它们包含重复项，则最后应用的绑定文件生效。 导入应用程序时，绑定按如下顺序应用：

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

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

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

    有关详细信息，请参阅 如何导入 BizTalk 应用程序。 有关使用绑定文件的背景信息，请参阅 绑定文件和应用程序部署。

使用情况

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

参数

参数 必须 值
/ApplicationName (或 /A，请参阅备注) 否 绑定文件要添加到的 BizTalk 应用程序的名称。 如果名称包含空格，则必须用双引号将其括起来 (“) 。 如果未指定应用程序名称，则将使用默认 BizTalk 应用程序。
/Type (或 /T，请参阅备注) 是 System.BizTalk：BizTalkBinding (此值不区分大小写。)
/Source (或 /So，请参阅备注) 是 绑定文件的完整路径，包含文件名。 如果路径包含空格，则必须用双引号将其括起来 (“) 。
/Property：TargetEnvironment= (或 /P：TargetEnvironment=，请参阅备注) 否 指定目标部署环境的字符串。 您可以使用任何字符串，如 Production。 示例： /Property：TargetEnvironment=“Production”

如果未指定，则会自动应用默认值<>。 值区分大小写。 如果该值包含空格，则必须将其括在双引号 (") 中。 环境值的最大长度为 128 个字符。
/Overwrite (或 /Ov，请参阅备注) 否 更新现有绑定文件的选项。 如果未指定，且应用程序中已经存在与要添加的文件同名的绑定文件，则 AddResource 操作将失败。
/Server (或 /Se，请参阅备注) 否 BizTalk 管理数据库的宿主 SQL Server 实例的名称，格式为“服务器名称\实例名称,端口”。

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

示例：

Server=MyServer

Server=MyServer\MySQLServer,1533

如果未提供，则使用本地计算机上运行的 SQL Server 实例的名称。
/Database (或 /Da，请参阅备注) 否 BizTalk 管理数据库的名称。 如果未提供，则使用在本地 SQL Server 实例中运行的 BizTalk 管理数据库。

示例

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

注解

属性名称区分大小写。 参数不区分大小写。 指定参数无需键入整个参数名，只需键入可明确标识该参数的参数名的前几个字母即可。

另请参阅

AddResource 命令
如何将绑定文件添加到应用程序