Freigeben über

Hinzufügen von vorab oder nachträglich verarbeiteten Skripts zu einer Anwendung

  • Artikel

In diesem Thema wird erläutert, wie Sie einer Anwendung mithilfe der BizTalk Server-Verwaltungskonsole oder der Befehlszeile ein vorab oder nachträglich verarbeitetes Skript hinzufügen. Wenn Sie einer Anwendung ein Skript hinzufügen, wird das Skript der MSI-Datei der Anwendung hinzugefügt und beim Importieren, Installieren oder Deinstallieren der Anwendung ausgeführt.

Beim Hinzufügen eines Skripts müssen Sie angeben, ob es sich um ein vorab verarbeitetes Skript (das zu Beginn des Imports oder der Installation der Anwendung ausgeführt wird) oder um ein nachträglich verarbeitetes Skript (das zum Abschluss des Imports oder der Installation der Anwendung ausgeführt wird) handelt. Vorab und nachträglich verarbeitete Skripts werden auch bei einer Deinstallation ausgeführt, und zwar in umgekehrter Reihenfolge als bei der Installation, d. h. vorab verarbeitete Skripts werden zum Abschluss und nachträglich verarbeitete Skripts zu Beginn der Deinstallation ausgeführt.

Sie können ein Skript auch aus einer Anwendung entfernen. Anweisungen finden Sie unter Entfernen eines Vor- oder Nachverarbeitungsskripts aus einer Anwendung.

Voraussetzungen

Zum Durchführen der Schritte in diesem Thema müssen Sie mit einem Konto angemeldet sein, das Mitglied der Gruppe BizTalk Server-Administratoren ist. Ausführlichere Informationen zu Berechtigungen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung.

So fügen Sie einer Anwendung ein Skript hinzu

Mithilfe der BizTalk Server-Verwaltungskonsole

  1. Klicken Sie auf Start, alle Programme, Microsoft BizTalk Server 20xx und dann auf BizTalk Server Verwaltung.

  2. Erweitern Sie die BizTalk-Gruppe, erweitern Sie Anwendungen, und klicken Sie dann mit der rechten Maustaste auf den Ordner der Anwendung, der Sie ein Skript hinzufügen möchten.

  3. Zeigen Sie auf Hinzufügen, und führen Sie eine der folgenden Aktionen aus:

    • Klicken Sie auf Vorverarbeitungsskripts , wenn das Skript ausgeführt werden soll, bevor der Anwendungsimport oder die Installation beginnt oder nach der Deinstallation.

    • Klicken Sie auf Nachbearbeitungsskripts , wenn das Skript nach dem Anwendungsimport oder der Installation oder vor der Deinstallation ausgeführt werden soll.

  4. Klicken Sie auf Hinzufügen , und navigieren Sie zu der hinzuzufügenden Skriptdatei.

  5. Wählen Sie die Skriptdatei aus, und klicken Sie auf Öffnen.

  6. Wenn Sie eine Skriptdatei überschreiben möchten, die bereits in der Anwendung vorhanden ist, aktivieren Sie das Kontrollkästchen Alle überschreiben . Damit eine Skriptdatei überschrieben wird, muss die hinzugefügte Datei denselben Dateinamen haben. Andernfalls wird das neue Skript hinzugefügt, und das vorhandene Skript bleibt in der Anwendung unverändert erhalten.

  7. Klicken Sie auf die Dropdownliste Dateityp , und klicken Sie auf den Dateityp – entweder System.BizTalk:PreprocessingScript oder System.BizTalk:PostprocessingScript.

  8. Geben Sie ggf. unter Zielspeicherort den Pfad ein, in den die Skriptdatei kopiert werden soll, wenn die Anwendung installiert wird, und klicken Sie dann auf OK. Mit dem Standardpfad wird das Skript im Installationsverzeichnis der Anwendung installiert (%BTAD_InstallDir%).

Hinweis

Wenn hier kein Pfad angegeben ist, wird das Skript bei der Installation nicht in das lokale Dateisystem kopiert. Damit das Skript bei der Deinstallation der Anwendung ausgeführt werden kann, müssen Sie hier einen Pfad angeben. Andernfalls ist das Skript im lokalen Dateisystem nicht vorhanden und wird bei der Deinstallation nicht ausgeführt.

Das Skript wird der Anwendung hinzugefügt und im Ordner Ressourcen der Anwendung angezeigt.

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 den folgenden Befehl ein, und ersetzen Sie dabei die entsprechenden Werte, wie in der folgenden Tabelle beschrieben:

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

    Beispiel:

    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"

    Parameter Wert
    /Applicationname Der Name der BizTalk-Anwendung, der das Skript hinzugefügt werden soll. Wenn der Anwendungsname nicht angegeben wurde, wird die BizTalk-Standardanwendung verwendet. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /Typ System.BizTalk:PreProcessingScript oder System.BizTalk:PostProcessingScript, je nach Typ des hinzuzufügenden Skripts. Verwenden Sie System.BizTalk:PreProcessingScript , wenn das Skript vor dem Import oder der Installation der Anwendung oder nach der Deinstallation ausgeführt werden soll. Verwenden Sie System.BizTalk:PostProcessingScript , wenn das Skript nach dem Import oder der Installation der Anwendung oder vor der Deinstallation ausgeführt werden soll.
    /Überschreiben Ein vorhandenes Skript aktualisieren. Wenn diese Option nicht angegeben ist, und die Anwendung bereits eine Skriptdatei mit demselben Namen wie die hinzuzufügende Datei enthält, schlägt das Hinzufügen fehl.
    /Quelle Der vollständige Pfad der Skriptdatei einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /Ziel Der vollständige Pfad des Speicherorts, an den die Skriptdatei kopiert werden soll, wenn die Anwendung aus der MSI-Datei installiert wird. Bei fehlender Angabe wird die Datei während der Installation nicht in das lokale Dateisystem kopiert. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /Server Der Name der SQL Server-Instanz, die als Host für die BizTalk-Verwaltungsdatenbank dient, im Format Servername\Instanzname,Port.

    Der Instanzname ist nur erforderlich, wenn sich der Instanzname vom Servernamen unterscheidet. Der Port ist nur erforderlich, wenn in SQL Server eine andere Portnummer als der Standardwert 1433 verwendet wird.

    Beispiele:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    Bei fehlender Angabe wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
    /Datenbank Der Name der BizTalk-Verwaltungsdatenbank. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.
    /Property:Args= Null oder mehr Argumente. Die hier angegebenen Argumente werden dem Skript beim Aufruf übergeben.

Weitere Informationen

Verwalten von vorab und nachträglich verarbeiteten Skripts
Befehl „AddResource“: Vorab verarbeitetes Skript
Befehl „AddResource“: Nachträglich verarbeitetes Skript