本主题介绍如何使用 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 管理控制台
依次单击“ 开始”、“ 所有程序”、“ Microsoft BizTalk Server 20xx”,然后单击 “BizTalk Server 管理”。
在控制台树中,展开 BizTalk Server 管理,然后展开包含要添加 BizTalk 程序集的应用程序的 BizTalk 组。
展开应用程序,找到您想要添加 BizTalk 程序集的特定应用程序。
右键单击 “资源”,指向“ 添加 ”,然后单击 “BizTalk 程序集”。
单击“ 添加”,选择 BizTalk 程序集文件,然后单击“ 打开”。
在 “目标”中,键入从 .msi 文件安装应用程序时要复制程序集文件的位置的完整路径,包括文件名。 如果未提供,则安装过程中不会将程序集文件复制到本地文件系统。
在 “选项”中,指定用于将 BizTalk 程序集安装到 GAC 的选项,然后单击“ 确定”。
使用命令行
按如下所示打开命令提示符:单击“ 开始”,单击“ 运行”,键入
cmd
,然后单击“ 确定”。键入以下命令,替换相应的值,如下表所述:
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 实例的名称,格式为 ServerName\InstanceName,Port。
仅当实例名称不同于服务器名称时,才需要实例名称。 仅当 SQL Server 使用默认值(1433)以外的端口号时,才需要端口。
例子:
Server=MyServer
Server=MyServer\MySQLServer,1533
如果未提供,则使用本地计算机上运行的 SQL Server 实例的名称。/数据库 BizTalk 管理数据库的名称。 如果未指定,将使用在本地 SQL Server 实例中运行的 BizTalk 管理数据库。