Befehl 'ImportBindings'

Mit diesem Befehl werden Bindungen aus einer XML-basierten Bindungsdatei in eine BizTalk-Anwendung oder -Gruppe importiert. Die Bindungen wurden möglicherweise aus einer Assembly, Anwendung oder Gruppe exportiert, wie unter Exportieren von Bindungen beschrieben. Je nach Herkunft der Bindungen haben die Parameter "ApplicationName" und "GroupLevel" unterschiedliche Auswirkungen. Weitere Informationen finden Sie unter "Hinweise" weiter unten in diesem Thema.

Hinweis

Bindungsdateien, die in BizTalk Server generiert werden, haben keine Anwendung angegeben. Diese Dateien werden in die Standardanwendung importiert.

Verbrauch

BTSTask ImportBindings -Source:value [-GroupLevel-ApplicationName | :value] [-Server:value] [-Database:value] [-ImportTrackingSettings:value] [-ExcludeParties]

Parameter

Parameter	Erforderlich	Wert
-Source (oder -So, siehe Hinweise)	Erforderlich	Der vollständige Pfad der zu importierenden Bindungsdatei, einschließlich des Dateinamens. Pfade, die Leerzeichen enthalten, müssen in Anführungszeichen (") gesetzt werden.
-GroupLevel (oder -G, siehe Hinweise)	Optional	Option zum Importieren der Bindungsdatei in die aktuelle Gruppe. Wenn Sie diesen Parameter angeben, dürfen Sie für "/ApplicationName" keine Angaben machen.
-ApplicationName (oder -A, siehe Hinweise)	Optional	Der Name der BizTalk-Anwendung, in die die Bindungen importiert werden sollen. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") einschließen. Wenn die Anwendung nicht existiert, schlägt der Importvorgang fehl. Ist dieser Parameter nicht festgelegt, wird die BizTalk-Standardanwendung verwendet. Wenn Sie diesen Parameter angeben, dürfen Sie für den Parameter "/GroupLevel" keine Angaben machen.
-Server (oder -Se, siehe Hinweise)	Optional	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.
-Database (oder -D, siehe Hinweise)	Optional	Der Name der BizTalk-Verwaltungsdatenbank. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.
-ImportTrackingSettings	Optional	Neu ab BizTalk Server 2016. Dadurch wird die Importoption für die globale Nachverfolgungseinstellung außer Kraft gesetzt. Ein "true"-Wert ermöglicht den Import von Überwachungseinstellungen. False lässt den Import der Nachverfolgungseinstellung nicht zu.
-ExcludeParties	Optional	Neu ab BizTalk Server 2016. Wenn angegeben, werden Parteieninformationen aus der Bindungsdatei ausgeschlossen.

Beispiel

Mit dem folgenden Befehl werden Bindungen in die Anwendung namens "MyApplication" in der BizTalk-Standardgruppe importiert.

BTSTask ImportBindings -ApplicationName:MyApplication -Source:C:\Bindings\Binding1.xml

Mit dem folgenden Befehl werden Bindungen in die Gruppe importiert, die in der BizTalk-Verwaltungsdatenbank definiert ist, die in einer SQL Server-Instanz namens "MY_Server" ausgeführt wird.

BTSTask ImportBindings -GroupLevel -Server:MY_Server -Database:BiztalkMgmtDb -Source:C:\Bindings\Binding1.xml

Hinweise

Bei Parametern wird die Groß- und Kleinschreibung nicht berücksichtigt. Zum Angeben von Parametern müssen Sie nicht den vollständigen Parameternamen eingeben. Es ist ausreichend, die ersten Buchstaben des Parameternamens einzugeben, die den Parameter eindeutig kennzeichnen.

Die Bindungen können aus einer Assembly, Anwendung oder Gruppe exportiert worden sein. Je nach Herkunft der Bindungen haben die Parameter "ApplicationName" und "GroupLevel" unterschiedliche Auswirkungen, wie in der folgenden Tabelle gezeigt.

Herkunft der Bindungen	Auswirkung beim Parameter "ApplicationName"	Auswirkung beim Parameter "GroupLevel"
Aus einer Assembly exportierte Bindungen	Die im Parameter "ApplicationName" angegebene Anwendung muss eine Assembly enthalten, deren Name mit dem der Assembly übereinstimmt, aus der die Bindungsdatei exportiert wurde. Andernfalls tritt beim Importvorgang ein Fehler auf.	Die aktuelle Gruppe muss eine Assembly und eine Anwendung enthalten, deren Namen mit denen der Assembly und der Anwendung übereinstimmen, aus denen die Bindungsdatei exportiert wurde. Andernfalls schlägt der Importvorgang fehl.
Aus einer Anwendung exportierte Bindungen	Die Anwendung, aus der die Bindungsdatei exportiert wurde, muss denselben Namen wie die im Parameter "ApplicationName" angegebene Anwendung haben. Andernfalls tritt beim Importvorgang ein Fehler auf.	Die Anwendung, aus der die Bindungsdatei exportiert wurde, muss denselben Namen haben wie eine Anwendung in der Gruppe, in die Sie die Bindungen importieren. Andernfalls tritt beim Importvorgang ein Fehler auf.
Aus einer Gruppe exportierte Bindungen	Die Gruppe, aus der die Bindungsdatei exportiert wurde, muss eine Anwendung enthalten, die denselben Namen wie die im Parameter "ApplicationName" angegebene Anwendung hat. Andernfalls tritt beim Importvorgang ein Fehler auf.	Bindungen werden für korrespondierende Anwendungen importiert. Mit anderen Worten: Die Bindungen einer Anwendung in der Gruppe, aus der Bindungen exportiert wurden, werden in eine Anwendung importiert, die in der aktuellen Gruppe denselben Namen trägt.

Weitere Informationen

Befehlszeilenreferenz für BTSTask
Importieren von Bindungen in eine BizTalk-Gruppe
Importieren von Bindungen in eine BizTalk-Anwendung