如何向应用程序添加预处理脚本和后处理脚本

项目
07/21/2023

本主题描述如何使用 BizTalk Server 管理控制台或命令行向应用程序添加预处理脚本或后处理脚本。在您将某一脚本添加到应用程序时，该脚本包括在应用程序的 .msi 文件中，并且在导入、安装或卸载该应用程序时运行。

添加脚本时，您必须指定它是预处理脚本（在应用程序导入或安装开始前运行）还是后处理脚本（在应用程序导入或安装完成运行）。预处理和后处理脚本也在卸载时运行，其顺序与在安装时运行的顺序相反：预处理脚本在卸载后运行，后处理脚本在卸载前运行。

您也可以从应用程序中删除脚本。有关说明，请参阅如何从应用程序中删除预处理或后期处理脚本。

必备条件

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

向应用程序添加脚本

使用 BizTalk Server 管理控制台

依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
依次展开 BizTalk 组和“应用程序”，然后右键单击要向其添加脚本的应用程序的文件夹。
指向 “添加”，然后执行下列操作之一：
- 如果希望脚本在应用程序导入或安装开始之前或卸载后运行，请单击“ 预处理 脚本”。
- 如果希望脚本在应用程序导入或安装之后或卸载之前运行，请单击“ 后期处理 脚本”。
单击“ 添加 ”并浏览到要添加的脚本文件。
选择脚本文件，然后单击“ 打开”。
如果要覆盖应用程序中已存在的脚本文件，请选择“覆盖所有检查框。该脚本文件必须与所添加的、要覆盖的文件同名。否则，将添加新的脚本，现有脚本仍将保留在应用程序中且没有任何改变。
单击“ 文件类型 ”下拉列表，然后单击文件类型 - System.BizTalk：PreprocessingScript 或 System.BizTalk：PostprocessingScript。
如有必要，请在 “目标位置 ”中键入要在安装应用程序时复制脚本文件的路径，然后单击“ 确定”。如果选择默认路径，则会将脚本安装到应用程序安装文件夹 (%BTAD_InstallDir%) 中。

注意

如果未提供此路径，则在安装时该脚本将不会复制到本地文件系统。如果在卸载应用程序时此脚本应运行，则确保提供该路径；否则，此脚本将不会在本地文件系统中存在，因此在卸载期间将无法运行。

该脚本将添加到应用程序中，并且显示在应用程序的“资源”文件夹中。

使用命令行

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

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

BTSTask AddResource [/ApplicationName：value] /Type：System.BizTalk：PreProcessingScript|System.BizTalk：PostProcessingScript [/Overwrite] /Source：value [/Destination：value] [/Server：value] [/Database：value][/Property：Args=“argument list”]

例如：

BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:PreProcessingScript /Overwrite /Source:"C:\Source Scripts\MyScript.vbs" /Destination:"C:\New Scripts\MyScript.vbs" /Server:MyDatabaseServer /Database:BizTalkMgmtDb /Property:Args="argument1 argument2"

参数	值
/ApplicationName	脚本要添加到的 BizTalk 应用程序的名称。如果未指定应用程序名称，则将使用默认 BizTalk 应用程序。如果名称包含空格，则必须用双引号 (“) 将其括起来。
/类型	System.BizTalk：PreProcessingScript 或 System.BizTalk：PostProcessingScript，具体取决于要添加的脚本类型。如果希望脚本在应用程序导入或安装之前或卸载后运行，请使用 System.BizTalk：PreProcessingScript 。如果希望脚本在应用程序导入或安装后或卸载之前运行，请使用 System.BizTalk：PostProcessingScript 。
/覆盖	更新现有脚本。如果未指定，且应用程序中已经存在与要添加的脚本文件同名的脚本文件，则添加操作将失败。
/源	脚本文件的完整路径，包含文件名。如果路径包含空格，则必须用双引号 (“) 将其括起来。
/目的地	从 MSI 文件安装应用程序时，脚本文件要复制到的位置的完整路径。如果未提供，则安装期间不会将该文件复制到本地文件系统。如果路径包含空格，则必须用双引号 (“) 将其括起来。
/服务器	BizTalk 管理数据库的宿主 SQL Server 实例的名称，格式为“服务器名称\实例名称,端口”。只在实例名称与服务器名称不相同时才需要指定实例名称。只在 SQL Server 不使用默认端口号 (1433) 时才需要指定端口。示例： Server=MyServer Server=MyServer\MySQLServer,1533 如果未提供，则使用本地计算机上运行的 SQL Server 实例的名称。
/数据库	BizTalk 管理数据库的名称。如果未指定，则使用在本地 SQL Server 实例中运行的 BizTalk 管理数据库。
/Property:Args=	零或更多参数。此处提供的参数将在调用脚本时传递到该脚本中。

另请参阅

管理预处理脚本和后期处理脚本
 AddResource 命令：预处理脚本
 AddResource 命令：后续处理脚本

Share via