如何向应用程序添加预处理脚本和后处理脚本
本主题描述如何使用 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= 零或更多参数。 此处提供的参数将在调用脚本时传递到该脚本中。