如何卸载 BizTalk 应用程序

本主题介绍如何使用“添加或删除程序”控制面板或 BTSTask 命令行工具卸载 BizTalk 应用程序。 这是卸载应用程序的唯一受支持的方法。 如果为此应用程序安装了多个 .msi 文件,例如为了更新应用程序,双击 .msi 文件或使用 msiexec 可能无法完全卸载应用程序,因此这些方法不被支持作为卸载方式。

谨慎

在运行时卸载 BizTalk 应用程序可能会导致应用程序中出现错误。 为避免此问题,最佳做法是建议验证应用程序没有正在运行的服务实例,如 “如何搜索所有服务实例”中所述。 如有必要,可以使用“完全停止”选项完全停止所有正在运行的实例来停止应用程序,如 如何启动和停止 BizTalk 应用程序中所述。 请注意,当您这样做时,正在处理中的消息将无法完成。

应将预处理脚本包含在应用程序 .msi 文件中,以在卸载应用程序时删除与应用程序关联的所有文件和设置。 如果尚未包含预处理脚本或后期处理脚本,本主题中的过程将从本地文件系统中删除应用程序的文件和设置,但有以下例外。

  • 如果应用程序包含虚拟目录,则删除虚拟目录及其文件,除非在安装应用程序后将文件添加到虚拟目录中。 在这种情况下,不会删除虚拟目录和添加的文件。 如果要删除虚拟目录和添加的文件,则必须明确地执行删除操作。

  • 删除预处理和后处理脚本,但在安装或卸载期间脚本添加的任何文件都不会被删除,脚本也不会撤消任何作。 如果要删除脚本添加的文件或撤消其动作,则必须显式地执行这些操作。

    注释

    只有在导入应用程序时在其部署属性中指定了目标位置的预处理或后期处理脚本才会在卸载期间运行。 有关详细信息,请参阅 如何向应用程序添加预处理脚本或后期处理脚本

  • 卸载 BizTalk 应用程序时,永远不会删除证书。 如果要删除证书,必须明确地进行删除。 此外,不会从 Windows 注册表中删除组件,并且不会从全局程序集缓存(GAC)中删除 BizTalk 程序集。 如果要删除它们,必须显式地进行。 有关详细信息,请参阅 如何删除 BizTalk 应用程序的其他文件和设置

    如果在卸载操作完成之前取消操作,BizTalk Server 将回滚卸载,但不包括在取消之前由预处理或后处理脚本执行的操作。 若要在开始卸载之前将应用程序还原到其状态,请双击 .msi 文件并重新安装该应用程序。 如果为此应用程序安装了多个 .msi 文件,则应双击每个 .msi 文件以按照最初安装 .msi 文件的顺序重新安装应用程序。

    有关后期处理脚本的详细信息,请参阅 使用预处理和后处理脚本自定义应用程序部署

注释

若要完全取消部署 BizTalk 应用程序,还必须从 BizTalk 组中删除它,如 如何从 BizTalk 组中删除 BizTalk 应用程序中所述。

先决条件

若要执行本主题中的过程,必须使用适当的权限登录。 有关详细信息,请参阅 部署和管理 BizTalk 应用程序所需的权限

卸载 BizTalk 应用程序

使用卸载或更改程序

  1. 在运行应用程序的计算机上,单击“ 开始”,单击 “控制面板”,然后双击“ 程序和功能”。

  2. “卸载或更改程序 ”页上,右键单击要删除的 BizTalk 应用程序,然后单击“ 卸载”。

    Windows Installer 删除指定的应用程序。

  3. 如果应用程序在多台计算机上运行,请对每台计算机重复这些步骤。

使用命令行

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

  2. 键入以下命令,替换相应的值,如下表所述:

    BTSTask UninstallApp [/ApplicationName:value]

    示例:

    BTSTask UninstallApp /ApplicationName:MyApplication

    参数 价值
    /ApplicationName 要卸载的 BizTalk 应用程序的名称。 如果名称包含空格,则必须用双引号(“)将其括起来。

另请参阅

取消部署 BizTalk 应用程序
UninstallApp 命令