Freigeben über


Deinstallieren einer BizTalk-Anwendung

In diesem Thema wird die Verwendung der Option Software in der Systemsteuerung bzw. des Befehlszeilenprogramms BTSTask zum Deinstallieren einer BizTalk-Anwendung erläutert. Zum Deinstallieren einer Anwendung werden nur diese Methoden unterstützt. Wenn Sie für die Anwendung mehrere MSI-Dateien installiert haben, z. B, zum Aktualisieren der Anwendung, wird durch Doppelklicken auf die MSI-Datei bzw. Verwenden des Befehls msiexec die Anwendung möglicherweise nicht vollständig deinstalliert. Aus diesem Grund werden diese Methoden zum Deinstallieren nicht unterstützt.

Achtung

Wenn Sie eine BizTalk-Anwendung während der Ausführung deinstallieren, kann dies zu einem Fehler in der Anwendung führen. Um dieses Problem zu vermeiden, sollten Sie als bewährte Methode sicherstellen, dass keine Dienstinstanzen für die Anwendung ausgeführt werden, wie unter Suchen nach allen Dienstinstanzen beschrieben. Bei Bedarf können Sie die Anwendung beenden, indem Sie die Option Vollständig beenden, um alle ausgeführten Instanzen vollständig zu beenden, wie unter Starten und Beenden einer BizTalk-Anwendung beschrieben. Achten Sie beim Anwenden dieser Option darauf, dass In-Process-Nachrichten nicht abgeschlossen werden.

Die MSI-Datei der Anwendung sollte ein vorab oder nachträglich verarbeitetes Skript enthalten, damit alle Dateien und Einstellungen, die mit der Anwendung verknüpft sind, bei der Deinstallation entfernt werden. Wenn kein vorab oder nachträglich verarbeitetes Skript enthalten ist, können alle Dateien und Einstellungen der Anwendung mithilfe der in diesem Thema beschriebenen Vorgehensweisen aus dem lokalen Dateisystem entfernt werden. Dabei gelten die im Folgenden erläuterten Ausnahmen.

  • Wenn die Anwendung ein virtuelles Verzeichnis enthält, wird das virtuelle Verzeichnis einschließlich seiner Dateien gelöscht, es sei denn, dem virtuellen Verzeichnis wurden nach der Installation Dateien hinzugefügt. In diesem Fall werden weder das virtuelle Verzeichnis noch die hinzugefügten Dateien gelöscht. Sie müssen das virtuelle Verzeichnis und die hinzugefügten Dateien manuell löschen.

  • Vorab und nachträglich verarbeitete Skripts werden gelöscht. Mithilfe dieser Skripts während der Installation oder Deinstallation hinzugefügte Dateien werden jedoch nicht gelöscht. Es werden ebenfalls keine Aktionen, die mithilfe dieser Skripts ausgeführt wurden, rückgängig gemacht. Sie müssen Dateien, die mithilfe dieser Skripts hinzugefügt wurden, manuell löschen, bzw. Aktionen manuell rückgängig machen.

    Hinweis

    Vorab oder nachträglich verarbeitete Skripts werden während der Deinstallation nur ausgeführt, wenn in den Bereitstellungseigenschaften beim Importieren der Anwendung ein Zielspeicherort angegeben wurde. Weitere Informationen finden Sie unter Hinzufügen eines Vor- oder Nachverarbeitungsskripts zu einer Anwendung.

  • Zertifikate werden bei der Deinstallation einer BizTalk-Anwendung nicht gelöscht. Sie müssen Zertifikate manuell löschen. Beachten Sie außerdem, dass Komponenten nicht aus der Windows-Registrierung und BizTalk-Assemblys nicht aus dem globalen Assemblycache (GAC) entfernt werden. Sie müssen diese manuell löschen. Weitere Informationen finden Sie unter Entfernen anderer Dateien und Einstellungen für eine BizTalk-Anwendung.

    Wenn Sie den Deinstallationsvorgang vorzeitig abbrechen, führt BizTalk Server ein Rollback der Deinstallation aus. Ausgenommen davon sind alle Aktionen, die vor dem Abbruch des Vorgangs von vorab oder nachträglich verarbeiteten Skripts ausgeführt wurden. Doppelklicken Sie auf die MSI-Datei, um den Status vor der Deinstallation wiederherzustellen, und installieren Sie die Anwendung erneut. Wenn für diese Anwendung mehrere MSI-Dateien installiert wurden, müssen Sie auf jede MSI-Datei doppelklicken, um die Anwendung in der Reihenfolge erneut zu installieren, in der die MSI-Dateien ursprünglich installiert wurden.

    Weitere Informationen zu Nachverarbeitungsskripts finden Sie unter Verwenden von Vor- und Nachverarbeitungsskripts zum Anpassen der Anwendungsbereitstellung.

Hinweis

Um die Bereitstellung einer BizTalk-Anwendung vollständig aufzuheben, müssen Sie sie auch aus der BizTalk-Gruppe löschen, wie unter Löschen einer BizTalk-Anwendung aus der BizTalk-Gruppe beschrieben.

Voraussetzungen

Sie können die in diesem Thema beschriebenen Arbeitsschritte nur ausführen, wenn Sie mit den entsprechenden Berechtigungen angemeldet sind. Weitere Informationen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung.

So deinstallieren Sie eine BizTalk-Anwendung

Verwenden von "Programm deinstallieren oder ändern"

  1. Klicken Sie auf dem Computer, auf dem die Anwendung ausgeführt wird, auf Start, auf Systemsteuerung, und doppelklicken Sie dann auf Programme und Features.

  2. Klicken Sie auf der Seite Programm deinstallieren oder ändern mit der rechten Maustaste auf die zu entfernende BizTalk-Anwendung, und klicken Sie dann auf Deinstallieren.

    Mithilfe von Windows Installer wird die angegebene Anwendung entfernt.

  3. Wenn die Anwendung auf mehreren Computern ausgeführt wird, wiederholen Sie diese Schritte auf allen Computern.

Verwenden der Befehlszeile

  1. Öffnen Sie eine Eingabeaufforderung wie folgt: Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie ein cmd, und klicken Sie dann auf OK.

  2. Geben Sie folgenden Befehl ein. Setzen Sie dabei den entsprechenden Wert ein, wie in der folgenden Tabelle beschrieben:

    BTSTask UninstallApp [/ApplicationName:value]

    Beispiel:

    BTSTask UninstallApp /ApplicationName:MyApplication

    Parameter Wert
    /Applicationname Der Name der BizTalk-Anwendung, die deinstalliert werden soll. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.

Weitere Informationen

Zurücknehmen der Bereitstellung von BizTalk-Anwendungen
Befehl „UninstallApp“