Hinzufügen einer Bindungsdatei zu einer Anwendung

Artikel
07/21/2023

Überblick

Verwenden Sie die BizTalk Server-Verwaltungskonsole oder die Befehlszeile, um einer BizTalk-Anwendung eine Bindungsdatei hinzuzufügen. Möglicherweise möchten Sie dies tun, um die Bereitstellung von Anwendungen oder Assemblys zu vereinfachen, wie unter Bindungsdateien und Anwendungsbereitstellung beschrieben.

Sie können Bindungen in eine .xml-Datei aus einer BizTalk-Anwendung für eine Assembly, Anwendung oder Gruppe exportieren, wie unter Exportieren von Bindungen beschrieben, und dann eine der Verfahren in diesem Thema verwenden, um die Bindungsdatei einer Anwendung hinzuzufügen.

Bei diesem Vorgang wird die Bindungsdatei der BizTalk-Verwaltungsdatenbank hinzugefügt und in der BizTalk Server-Verwaltungskonsole im Ordner Ressourcen der Anwendung angezeigt. Anders als beim Importieren werden Bindungen beim Hinzufügen einer Bindungsdatei nicht sofort angewendet. Stattdessen werden die Bindungen erst angewendet, wenn die Anwendung in eine andere BizTalk-Gruppe importiert wird.

Wichtig

Wenn Sie Bindungen exportieren, werden die Kennwörter für die Bindungen aus Sicherheitsgründen von BizTalk Server aus der Bindungsdatei entfernt. Nach dem Importieren der Bindungen müssen Sie die Kennwörter für Sendeports und Empfangsspeicherorte neu konfigurieren, damit sie ordnungsgemäß funktionieren. Kennwörter für den Sendeport und den Empfangsspeicherort können Sie im Dialogfeld Transporteigenschaften der BizTalk Server-Verwaltungskonsole konfigurieren. Weitere Informationen finden Sie unter Erstellen eines Sendeports oder Erstellen eines Empfangsspeicherorts.

Hinweis

Wenn Sie eine Bindungsdatei verwenden, sollten Sie überprüfen, ob die Artefakte an den richtigen Host gebunden wurden und ob die Vertrauensebene angemessen ist.

Beim Hinzufügen einer Bindungsdatei zu einer Anwendung können Sie mit einer Zeichenfolge, die die Umgebung beschreibt, einen Wert für die Zielbereitstellungsumgebung angeben, beispielsweise Test oder Produktion. Für diesen Wert können Sie eine beliebige Zeichenfolge verwenden. Anschließend können Sie beim Importieren der Anwendung auswählen, welche Bindungsdatei angewendet werden soll, indem Sie den Wert angeben, der für die entsprechende Zielumgebung festgelegt wurde. Dabei werden die Bindungen aus der entsprechenden Bindungsdatei verwendet. In der Anwendung bereits vorhandene Bindungen mit denselben Namen wie Bindungen in der Datei werden automatisch überschrieben.

Beim Importieren einer Anwendung werden Bindungen in der folgenden Reihenfolge angewendet. Beim Anwenden von Bindungen während des Imports werden bereits angewendete Bindungen durch gleichnamige neue Bindungen überschrieben. Mit anderen Worten: Die letzte anzuwendende Bindung eines bestimmten Namens wird gültig.

Von BizTalk Server generierte Anwendungsbindungen, die der Anwendung nicht explizit über eine Bindungsdatei hinzugefügt, jedoch vom Benutzer explizit für den Export in die MSI-Datei der Anwendung ausgewählt wurden.
Bindungsdateien, die explizit hinzugefügt wurden und für die keine Zielbereitstellungsumgebung festgelegt ist. Für die Anwendung der Bindungen in dieser Gruppe gilt keine bestimmte Reihenfolge.
Bindungen, die explizit hinzugefügt wurden und für die eine Zielbereitstellungsumgebung festgelegt ist, die mit der für den Anwendungsimport ausgewählten Bereitstellungsumgebung übereinstimmt. Für die Anwendung der Bindungen in dieser Gruppe gilt keine bestimmte Reihenfolge.

Weitere Informationen zum Importieren von Anwendungen und zum Anwenden von Bindungen finden Sie unter Importieren einer BizTalk-Anwendung.

Voraussetzungen

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe BizTalk Server Administratoren ist. Berechtigungen, die für das Bereitstellen und Verwalten einer BizTalk-Anwendung erforderlich sind , enthält weitere Details.

Hinzufügen einer Bindungsdatei mithilfe der BizTalk-Verwaltung

Öffnen Sie BizTalk Server Verwaltung (im Menü Start).
Erweitern Sie BizTalk Server Verwaltung, erweitern Sie die BizTalk-Gruppe, erweitern Sie Anwendungen, und klicken Sie mit der rechten Maustaste auf die Anwendung, der Sie eine Bindungsdatei hinzufügen möchten.
Zeigen Sie auf Hinzufügen, und klicken Sie dann auf Ressourcen.
Klicken Sie auf Hinzufügen, wählen Sie die hinzuzufügende Datei aus, und klicken Sie dann auf Öffnen.
Um eine vorhandene Bindungsdatei in dieser Anwendung mit demselben Dateinamen zu überschreiben, aktivieren Sie das Kontrollkästchen Alle überschreiben . Wenn eine andere Datei mit demselben Namen vorhanden ist und Sie dieses Kontrollkästchen nicht aktivieren, schlägt der Vorgang zum Hinzufügen fehl.
Wählen Sie in der Dropdownliste Dateityp die Option System.BizTalk:BizTalkBinding aus.
Geben Sie unter Zielumgebung eine Zeichenfolge ein, um die Zielbereitstellungsumgebung darzustellen, in der die Bindungen in dieser Datei angewendet werden sollen, z. B. Test, und klicken Sie auf OK.

Wichtig

Wenn Sie dieses Feld leer lassen, werden die Bindungen in dieser Datei beim Anwendungsimport immer angewendet.

Die Bindungsdatei wird hinzugefügt und im Ordner Ressourcen der Anwendung angezeigt.

Hinzufügen einer Bindungsdatei über die Befehlszeile

Öffnen Sie eine Eingabeaufforderung (Startmenü> wählen cmd> Sie Eingabeaufforderung aus).

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:BizTalkBinding [/Overwrite] /Source:value/Property:TargetEnvironment="value" [/Server:value] [/Database:value]

Beispiel:

BTSTask AddResource /ApplicationName:"Meine Anwendung" /Type:System.BizTalk:BizTalkBinding /Source:"C:\Binding Files\MyBinding.xml" /Property:TargetEnvironment="Production" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

Parameter	Wert
/Applicationname	Der Name der BizTalk-Anwendung, der die Bindungsdatei 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:BizTalkBinding (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.)
/Überschreiben	Option zum Aktualisieren einer vorhandenen Bindungsdatei. Wenn dies nicht angegeben ist und die Bindungsdatei bereits in der Anwendung vorhanden ist, die denselben Dateinamen wie die hinzugefügte Datei aufweist, schlägt der AddResource-Vorgang fehl.
/Quelle	Der vollständige Pfad der Bindungsdatei einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
/Property:TargetEnvironment=	Eine Zeichenfolge, die die Zielbereitstellungsumgebung angibt. Sie können eine beliebige Zeichenfolge verwenden (z. B. "Produktion"). Beispiel: /Property:TargetEnvironment="Production" Wenn nicht angegeben, wird automatisch der Wert Default <> angewendet. Beim Wert wird die Groß-/Kleinschreibung berücksichtigt. Enthält der Wert Leerzeichen, müssen Sie ihn in doppelte Anführungszeichen (") setzen. Die maximale Länge des Umgebungswertes beträgt 128 Zeichen.
/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“: BizTalk-Bindung
Erstellen und Bearbeiten von BizTalk-Anwendungen

Freigeben über