通过

如何向应用程序中添加 BizTalk 程序集

  • 项目

本主题介绍如何使用 BizTalk Server 管理控制台或命令行向应用程序添加 BizTalk 程序集。

向应用程序中添加 BizTalk 程序集时，请切记以下几点：

  • 如果您要使用已在应用程序中存在的相同本地唯一标识符 (LUID) 添加某一程序集和覆盖某一程序集，则指定“Overwrite”选项。 如果未指定，且应用程序中已存在与要添加的程序集具有相同 LUID 的程序集，则该操作将失败。 LUID 包括程序集文件名、版本、区域性和公钥标记。 可以使用 ListApp 命令查看应用程序中项目的 LUID。

  • 如果要添加的程序集依赖于并未包含在该应用程序中的其他项目，则添加操作将失败。

  • 在添加某一 BizTalk 程序集时，可以指定以下一个或多个选项，以便将该程序集安装到全局程序集缓存 (GAC) 中：

    • 添加资源时添加到全局程序集缓存 (gacutil)。 如果您选择了此选项，则在按照本主题中介绍的过程将程序集添加到某一应用程序时，该程序集就会安装到本地计算机上的 GAC 中。

    • 导入 MSI 文件时添加到全局程序集缓存 (gacutil)。 如果您选择了此选项，则在应用程序导出到某一 .msi 文件，然后该 .msi 文件导入到 BizTalk 组时，程序集将作为导入过程的一部分安装到本地计算机上的 GAC 中。

    • 安装 MSI 文件时添加到全局程序集缓存 (gacutil)。 如果您选择了此选项，则在应用程序导出到某一 .msi 文件，然后应用程序根据该 .msi 文件安装到某一计算机时，程序集将作为安装过程的一部分安装到本地计算机上的 GAC 中。

必备条件

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

向应用程序中添加 BizTalk 程序集

使用 BizTalk Server 管理控制台

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

  2. 在控制台树中，展开BizTalk Server“管理”和包含要向其添加 BizTalk 程序集的应用程序的 BizTalk 组。

  3. 展开包含要添加 BizTalk 程序集的应用程序。

  4. 右键单击“ 资源”，指向“ 添加 ”，然后单击“ BizTalk 程序集”。

  5. 单击“ 添加”，选择 BizTalk 程序集文件，然后单击“ 打开”。

  6. 在 “目标”中，键入从 .msi 文件安装应用程序时要复制程序集文件的位置的完整路径，包括文件名。 如果未提供，则安装期间该程序集文件将不会复制到本地文件系统。

  7. 在 “选项”中，指定用于将 BizTalk 程序集安装到 GAC 的选项，然后单击“ 确定”。

使用命令行

  1. 按如下所示打开命令提示符：单击“ 开始”，单击“ 运行”，键入 cmd，然后单击“ 确定”。

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

    BTSTask AddResource [/ApplicationName：value] /Type：System.BizTalk：BizTalkAssembly [/Overwrite] /Source：value [/Destination：value] [/Options：GacOnAdd|GacOnInstall|GacOnImport] [/Server：value] [/Database：value]

    例如：

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite /Source:"C:\BizTalk Assemblies\MyOrchestration.dll" /Destination:"C:\New BizTalk Assemblies\ MyOrchestration.dll " /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    参数 值
    /ApplicationName 向其添加 BizTalk 程序集的 BizTalk 应用程序的名称。 如果未指定应用程序名称，则将使用默认 BizTalk 应用程序。 如果名称包含空格，则必须用双引号 (“) 将其括起来。
    /类型 System.BizTalk:BizTalkAssembly
    /覆盖 更新现有程序集的选项。 如果未指定，且应用程序中已存在与要添加的程序集具有相同 LUID 的程序集，则 AddResource 操作将失败。 可以使用 ListApp 命令查看应用程序中项目的 LUID。 如果其他应用程序依赖于要覆盖的程序集，则即使指定了此参数，AddResource 操作也会失败。
    /源 程序集文件的完整路径，包含文件名。 如果路径包含空格，则必须用双引号 (“) 将其括起来。
    /目的地 从 .msi 文件安装应用程序时，程序集文件要复制到的位置的完整路径。 如果未提供，则安装期间该程序集文件将不会复制到本地文件系统。 如果路径包含空格，则必须用双引号 (“) 将其括起来。
    /选项 - GacOnAdd：指定在 AddResource 操作期间将程序集安装到本地计算机上的全局程序集缓存 (GAC) 。
    - GacOnInstall：指定在从 .msi 文件安装应用程序时将程序集安装到 GAC。
    - GacOnImport：指定在导入应用程序 .msi 文件时将程序集安装到 GAC。

    多个选项之间必须用逗号分开。
    /服务器 BizTalk 管理数据库的宿主 SQL Server 实例的名称，格式为“服务器名称\实例名称,端口”。

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

    示例：

    Server=MyServer

    Server=MyServer\MySQLServer,1533

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

另请参阅

管理 BizTalk 程序集
AddResource 命令：BizTalk 程序集