Teilen über

Hinzufügen eines BAM-Elements zu einer Anwendung

  • Artikel

In diesem Thema wird erläutert, wie Sie mithilfe der BizTalk Server-Verwaltungskonsole oder über die Befehlszeile ein BAS-Element zu einer BizTalk-Anwendung hinzufügen. Durch das Hinzufügen einer BAM-Definitionsdatei wird die BAM-Definition nicht bereitgestellt. Die BAM-Definition wird durch das Importieren der MSI-Datei der Anwendung bereitgestellt.

Wenn Sie ein BAM-Element überschreiben möchten, das in der Anwendung bereits vorhanden ist, müssen Sie die Option zum Überschreiben festlegen. Die Überschreibungsoption ist nur erforderlich, wenn das vorhandene BAM-Artefakt denselben Dateinamen hat wie das, das Sie hinzufügen möchten. Wenn nicht angegeben und BAM-Artefakt bereits in der Anwendung mit demselben Dateinamen wie der hinzugefügte vorhanden ist, schlägt der Add-Vorgang fehl.

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 BAM-Element hinzu

Mithilfe der BizTalk Server-Verwaltungskonsole

  1. Klicken Sie auf Start, auf Al Programme, dann auf Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk Server Administration.

  2. Erweitern Sie in der Konsolenstruktur BizTalk Server Verwaltung, die BizTalk-Gruppe, anwendungen und dann die Anwendung, der Sie eine BAM-Artefaktdatei hinzufügen möchten.

  3. Klicken Sie mit der rechten Maustaste auf den Ordner Ressourcen , zeigen Sie auf Hinzufügen, und klicken Sie dann auf Ressourcen.

  4. Klicken Sie auf Hinzufügen, wählen Sie die Datei des BAM-Artefakts aus, und klicken Sie dann auf Öffnen.

  5. Wählen Sie in der Dropdownliste Dateityp die Option System.BizTalk:BAM aus.

  6. Geben Sie unter Ziel den vollständigen Pfad des Speicherorts ein, an dem die Artefaktdatei kopiert werden soll, wenn die Anwendung aus der .msi-Datei installiert wird, einschließlich des Dateinamens. Wenn dieser Pfad nicht zur Verfügung steht, kann die Datei während der Installation nicht in das lokale Dateisystem kopiert werden. Sie wird jedoch beim Importieren der MSI-Datei der Anwendung bereitgestellt.

    Beispiel: C:\My Applications\MyBAMfile.xml

  7. Wenn Sie fertig sind, klicken Sie auf OK.

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 die entsprechenden Werte, wie in der folgenden Tabelle beschrieben:

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Bam [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value]

    Beispiel:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Bam /Overwrite /Source:"C:\Source BAMfiles\MyBAMfile.xml" /Destination:"%BTADInstallDir%\ BAMfiles\MyBAMfile.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parameter Wert
    /Applicationname Der Name der BizTalk-Anwendung, der das BAM-Element hinzugefügt werden soll. Wenn der Anwendungsname nicht angegeben ist, wird die BizTalk-Standardanwendung für die Gruppe verwendet. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /Typ System.BizTalk:Bam (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.)
    /Überschreiben Option zum Überschreiben eines vorhandenen BAM-Elements. Wenn diese Option nicht angegeben ist und die Anwendung bereits ein BAM-Element mit dem gleichen Namen wie das hinzuzufügende BAM-Element enthält, schlägt der AddResource-Vorgang fehl.
    /Quelle Der vollständige Pfad der BAM-Elementdatei einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /Ziel Vollständiger Pfad des Speicherorts, an den die BAM-Elementdatei 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. Mithilfe der Umgebungsvariable %BTAD_InstallDir% können Sie den Installationsordner der Anwendung im Pfad angeben.
    /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.

Weitere Informationen

Verwalten von .NET-Assemblys, Zertifikaten und anderen Ressourcen
Befehl „AddResource“: BAM-Element
Erstellen und Bearbeiten von BizTalk-Anwendungen
Importieren einer BizTalk-Anwendung