本主题介绍如何使用 BizTalk Server 管理控制台或命令行将 COM 组件添加到 BizTalk 应用程序:
将 COM 组件添加到应用程序时,请记住以下要点:
如果要覆盖应用程序中已存在的 COM 组件,请指定“覆盖”选项。 仅当两个项目具有相同的本地唯一标识符(LUID)时,才需要重写选项。 如果未指定,并且应用程序中已有一个具有相同 LUID 的 COM 组件,则添加操作将失败。 可以使用 ListApp 命令查看应用程序中项目的 LUID。
BizTalk Server 不会检查 COM 组件的依赖项,以验证它们是否存在,因此您应验证组件所依赖的任何项目是否存在。
如果添加 64 位非托管 COM 或 COM+ 组件,并且尝试在 32 位计算机上安装包含 COM 或 COM+ 组件的应用程序,则不会安装该组件。 它将仅在 64 位计算机上安装。
先决条件
若要执行本主题中的过程,必须使用属于 BizTalk Server 管理员组成员的帐户登录。 有关权限的详细信息,请参阅 部署和管理 BizTalk 应用程序所需的权限。
将 COM 组件添加到应用程序
使用 BizTalk Server 管理控制台
依次单击“ 开始”、“ 程序”、“ Microsoft BizTalk Server 20xx”,然后单击 “BizTalk Server 管理”。
在控制台树中,展开 BizTalk Server 管理、BizTalk 组、应用程序,然后展开要向其添加 COM 组件的应用程序。
右键单击 “资源 ”文件夹,指向 “添加”,然后单击“ 资源”。
单击“ 添加”,选择 COM 组件,然后单击“ 打开”。
在 文件类型 下拉列表中,单击 System.BizTalk:Com。
在 “选项”中,根据是否希望在安装应用程序时将组件添加到 Windows 注册表,选中或清除 目标处注册文件(regsvr32) 复选框。
在 “目标”中,键入从 .msi 文件(包括文件名)安装应用程序时要复制 COM 组件的位置的完整路径。 如果未提供此路径,则安装过程中该文件不会复制到本地文件系统。 如果在上一步中选择了 “在目标(regsvr32)处注册文件 ”复选框,则需要此路径。
示例: %BTAD_InstallDir%\MyComponent.dll
完成后,单击 “确定” 。
使用命令行
按如下所示打开命令提示符:单击“ 开始”,单击“ 运行”,键入
cmd
,然后单击“ 确定”。键入以下命令,替换相应的值,如下表所述:
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Com [/Overwrite] /Source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]
示例:
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Com /Overwrite /Source:"C:\Source Components\COM.dll" /Destination:"C:\New Components\COM.dll" /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb
参数 价值 /ApplicationName 要向其添加 COM 组件的 BizTalk 应用程序的名称。 如果未指定应用程序名称,则使用组的默认 BizTalk 应用程序。 如果名称包含空格,则必须用双引号(“)将其括起来。 /类型 System.BizTalk:Com (此值不区分大小写。 /改写 用于更新现有 COM 组件的选项。 如果未指定,并且应用程序中已经存在与要添加的 COM 组件具有相同 LUID 的 COM 组件,则 AddResource 操作将失败。 可以使用 ListApp 命令查看应用程序中项目的 LUID。 /源 COM 组件文件 .dll 的完整路径,包括文件名。 如果路径包含空格,则必须用双引号()将其括起来。 /目的地 从 .msi 文件安装应用程序时要复制 COM 组件 .dll 文件的位置的完整路径。 如果未提供,则安装过程中该文件不会复制到本地文件系统;因此,安装过程中无法将组件添加到 Windows 注册表。 如果路径包含空格,则必须用双引号()将其括起来。 如果指定 Regsvr32OnInstallOption,则还必须指定目标。 /选项 Regsvr32OnInstall。 指定从 .msi 文件安装应用程序时将 COM 组件添加到 Windows 注册表。 如果指定此选项,还必须指定目标。 /服务器 托管 BizTalk 管理数据库的 SQL Server 实例的名称,格式为 ServerName\InstanceName,Port。
仅当实例名称不同于服务器名称时,才需要实例名称。 仅当 SQL Server 使用默认值(1433)以外的端口号时,才需要端口。
例子:
Server=MyServer
Server=MyServer\MySQLServer,1533
如果未提供,则使用本地计算机上运行的 SQL Server 实例的名称。/数据库 BizTalk 管理数据库的名称。 如果未指定,将使用在本地 SQL Server 实例中运行的 BizTalk 管理数据库。
另请参阅
管理 .NET 程序集、证书和其他资源
AddResource 命令:COM 组件
创建和修改 BizTalk 应用程序