AddResource 命令:.NET 程序集

若要将包含托管 COM 或 COM+ 组件的 .NET 程序集) (添加到 BizTalk 应用程序,请使用 AddResource 命令并为 Type 参数指定 System.BizTalk:Assembly 。 运行此命令可将程序集添加到 BizTalk 管理数据库中。 程序集还会显示在 BizTalk 管理控制台中,即它所添加到的应用程序的“资源”文件夹中。 此外,使用 ListApp 命令时会列出程序集。

如果要添加的程序集的全名与应用程序中已经存在的程序集的全名相同,可以指定 Overwrite 参数。 全名包括名称、公钥标记、区域性和版本。 在这种情况下,现有程序集将被覆盖。 有关依赖项的详细信息,请参阅 依赖项和应用程序部署

使用情况

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

参数

参数 必须
/ApplicationName (或 /A,请参阅备注) 向其添加程序集的 BizTalk 应用程序的名称。 如果名称包含空格,则必须用双引号将其括起来 (“) 。 如果未指定应用程序名称,则使用组的默认 BizTalk 应用程序。
/Type (或 /T,请参阅备注) System.BizTalk:Assembly (此值不区分大小写。)
/Overwrite (或 /Ov,请参阅备注) 更新现有程序集的选项。 如果未指定,且应用程序中已存在与要添加的程序集具有相同全名的程序集,则 AddResource 操作将失败。 全名包括程序集名称、版本、区域性和公钥标记。 此信息显示在 BizTalk Server 管理控制台中,即该应用程序的“资源”文件夹的“名称”字段中。
/Source (或 /So,请参阅备注) 程序集文件的完整路径,包含文件名。 如果路径包含空格,则必须用双引号将其括起来 (“) 。
/Destination (或 /De,请参阅备注) 从 .msi 文件安装应用程序时,程序集文件要复制到的位置的完整路径。 如果未提供,则安装期间该程序集文件将不会复制到本地文件系统。 如果路径包含空格,则必须用双引号将其括起来 (“) 。 如果指定 RegasmOnInstall 或 RegsvcsOnInstall 选项,则还必须指定 Destination。 注意: 可以使用 %BTAD_InstallDir% 环境变量来指定应用程序安装文件夹。 这会在不同的目标计算机上为应用程序的文件创建一个一致的位置。 例如:“%BTAD_InstallDir%\MyAssemblies\Orchestrations.dll”
/Options (或 /Op,请参阅备注) - GacOnAdd:在 AddResource 操作期间,将程序集安装到本地计算机上的全局程序集缓存 (GAC) 。
- GacOnInstall:从 .msi 文件安装应用程序时,将程序集安装到 GAC。
- GacOnImport:导入应用程序 .msi 文件时,将程序集安装到 GAC。
- RegasmOnInstall:从 .msi 文件安装应用程序时,将托管 COM 程序集添加到 Windows 注册表。 如果指定此选项,则还必须指定 Destination。
- RegsvcsOnInstall:从 .msi 文件安装应用程序时,将托管 COM+ 程序集添加到 Windows 注册表。 如果指定此选项,则还必须指定 Destination。

多个选项之间必须用逗号分开。 逗号和值之间不能有空格。
/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:Assembly /Overwrite /Source:“%BTAD_InstallDir%\Source Assemblies\MyAssembly.dll” /Destination:“%BTAD_InstallDir%\New Assemblies\MyAssembly.dll” /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

注解

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

另请参阅

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