AddResource 命令:BizTalk 程序集

若要将 BizTalk 程序集添加到 BizTalk 应用程序,请使用 AddResource 命令并为 Type 参数指定 System.BizTalk:BizTalkAssembly 。 运行此命令可将程序集添加到 BizTalk 管理数据库中。 该程序集还会显示在 BizTalk Server 管理控制台中,即它所添加到的应用程序的“资源”文件夹下。 该程序集中包含的项目也会显示在相应的文件夹下。 此外,使用 ListApp 命令时,还会列出项目。

使用此命令时,请切记以下几点:

  • 如果某个程序集与应用程序中已存在的程序集具有相同的全名,则必须指定“Overwrite”参数,否则 AddResource 操作将失败。 全名包括名称、公钥标记、区域性和版本。 但是,如果其他应用程序依赖于此程序集,则即使指定了“Overwrite”参数,AddResource 操作也会失败。

  • 如果组中存在具有同一全名的其他程序集,则即使指定了“Overwrite”参数,AddResource 操作也会失败。

  • 如果要覆盖包含业务流程的程序集,则在运行此命令之前,必须先停止并取消登记这些业务流程。 此外,必须停止并取消登记业务流程绑定到的发送端口,并且必须禁用接收位置。

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

    有关依赖项的详细信息,请参阅 依赖项和应用程序部署

使用情况

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

参数

参数 必须
/ApplicationName (或 /A,请参阅备注) 向其添加程序集的 BizTalk 应用程序的名称。 如果名称包含空格,则必须用双引号 (“) 将其括起来。 如果未指定应用程序名称,则将使用默认 BizTalk 应用程序。
/键入 (或 /T,请参阅备注) System.BizTalk:BizTalkAssembly (此值不区分大小写。)
/Overwrite (或 /Ov,请参阅备注) 更新现有程序集的选项。 如果未指定,且应用程序中已存在与要添加的程序集具有相同全名的程序集,则 AddResource 操作将失败。 全名对应于程序集的本地唯一标识符 (LUID)。 可以使用 ListApp 命令查看应用程序中项目的 LUID。 如果其他应用程序依赖于要覆盖的程序集,则即使指定了此参数,AddResource 操作也会失败。
/Source (或 /So,请参阅备注) 程序集文件的完整路径,包含文件名。 如果路径包含空格,则必须用双引号 (“) 将其括起来。
/Destination (或 /De,请参阅备注) 从 .msi 文件安装应用程序时,程序集文件要复制到的位置的完整路径。 如果未提供,则安装期间该程序集文件将不会复制到本地文件系统。 如果路径包含空格,则必须用双引号 (“) 将其括起来。 注意:可以使用在BizTalk Server安装期间设置的环境变量 %BTAD_InstallDir% 来指定应用程序安装文件夹。 这将在其他目标计算机上为应用程序的文件创建一致的安装位置。 例如:“%BTAD_InstallDir%\MyFiles\Orchestrations.dll”
/Options (或 /Op,请参阅备注) - GacOnAdd:指定在 AddResource 操作期间将程序集安装到本地计算机上的全局程序集缓存 (GAC) 。
- GacOnInstall:指定在从 .msi 文件安装应用程序时将程序集安装到 GAC。
- GacOnImport:指定在导入应用程序 .msi 文件时将程序集安装到 GAC。

多个选项之间必须用逗号分开。
/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:BizTalkAssembly /Overwrite

/Source:"%BTAD_InstallDir%\Source Assemblies\Orchestrations.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\Orchestrations.dll" /Options:GacOnInstall,GacOnImport /Server:MyDatabaseServer /Database:BizTalkMgmtDb

注解

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

另请参阅

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