Befehl „AddResource“: BizTalk-Bindung
Um einer BizTalk-Anwendung eine Bindungsdatei hinzuzufügen, verwenden Sie den Befehl AddResource und geben System.BizTalk:BizTalkBinding für den Type-Parameter an. Beim Hinzufügen einer Bindungsdatei können Sie eine Bereitstellungsumgebung dafür angeben. Wenn Sie die Anwendung zu einem späteren Zeitpunkt importieren, können Sie diese Bereitstellungsumgebung auswählen, um die Bindungen anzuwenden. Einer BizTalk-Anwendung kann eine beliebige Anzahl von Bindungsdateien hinzugefügt werden, von denen jede an eine andere Bereitstellungsumgebung angepasst ist. Wenn Sie mehrere Bindungsdateien hinzufügen möchten, führen Sie diesen Befehl für jede Datei aus, die hinzugefügt werden soll.
Sie können eine Bindungsdatei hinzufügen, die Sie für eine Assembly, Anwendung oder Gruppe exportiert haben, wie unter ExportBindings-Befehl beschrieben, und dann den Befehl AddResource verwenden, um die Bindungsdatei einer Anwendung hinzuzufügen.
Wenn Sie diesen Befehl ausführen, wird die Bindungsdatei der BizTalk-Verwaltungsdatenbank hinzugefügt, und die Datei wird im Ressourcenordner der Anwendung angezeigt. Darüber hinaus wird die Datei aufgelistet, wenn Sie den ListApp-Befehl verwenden. Anders als beim Importieren werden vorhandene Bindungen beim Hinzufügen einer Bindungsdatei nicht sofort geändert. Die Bindungen werden erst dann angewendet, wenn die Anwendung in eine andere BizTalk-Gruppe importiert wird.
Wenn Sie eine Bindungsdatei hinzufügen, können Sie deren Bereitstellungsumgebung mithilfe des optionalen "/Property"-Parameters "TargetEnvironment" angeben. Als Wert kann eine beliebige Zeichenfolge angegeben werden, die die Bereitstellungsumgebung darstellt, in der Sie die Bindungen in dieser Datei anwenden möchten (z. B. "Test" oder "Produktion"). Wenn Sie keinen Wert für den /Property-Parameter angeben, wird automatisch der Wert <Default> angegeben, und diese Bindungsdatei wird jedes Mal angewendet, wenn die Anwendung importiert wird.
Wenn Sie eine Anwendung importieren, die mindestens eine Bindungsdatei enthält, die auf diese Weise explizit hinzugefügt wurde, können Sie wählen, welche Bindungsdatei bzw. Bindungsdateien angewendet werden sollen, indem Sie den Wert des "/Property"-Parameters angeben. Bindungen werden beim Anwendungsimport 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. Dies sollten Sie beachten, wenn Sie mehrere Bindungsdateien verwenden. Enthalten die Dateien doppelte Einträge, wird die zuletzt angewendete Bindung gültig. Beim Importieren einer Anwendung werden Bindungen in der folgenden Reihenfolge angewendet:
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 finden Sie unter Importieren einer BizTalk-Anwendung. Hintergrundinformationen zur Verwendung von Bindungsdateien finden Sie unter Bindungsdateien und Anwendungsbereitstellung.
Verbrauch
BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalkBinding/Property:TargetEnvironment="value" [/Overwrite] /Source:value [/Server:value] [/Database:value]
Parameter
| Parameter | Erforderlich | Wert |
|---|---|---|
| /ApplicationName (oder /A, siehe Hinweise) | No | Der Name der BizTalk-Anwendung, der die Bindungsdatei hinzugefügt werden soll. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen. Wenn der Anwendungsname nicht angegeben wurde, wird die BizTalk-Standardanwendung verwendet. |
| /Type (oder /T, siehe Hinweise) | Yes | System.BizTalk:BizTalkBinding (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.) |
| /Source (oder /So, siehe Hinweise) | Yes | 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= (oder /P:TargetEnvironment=, siehe Hinweise) | No | 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. |
| /Überschreiben (oder /Ov, siehe Hinweise) | No | Option zum Aktualisieren einer vorhandenen Bindungsdatei. Wenn diese Option nicht angegeben ist und die Anwendung bereits eine Bindungsdatei mit demselben Namen wie die hinzuzufügende Datei enthält, schlägt der AddResource-Vorgang fehl. |
| /Server (oder /Se, siehe Hinweise) | No | 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 /Da, siehe Hinweise) | No | Der Name der BizTalk-Verwaltungsdatenbank. Falls nicht angegeben, wird die BizTalk Management-Datenbank verwendet, die im lokalen instance von SQL Server ausgeführt wird. |
Beispiel
BTSTask AddResource /ApplicationName:MyApplication /type:System.BizTalk:BizTalkBinding /Property:TargetEnvironment=Test /Source:"C:\Binding Files\MyBinding.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
Hinweise
Bei Eigenschaftennamen wird zwischen Groß- und Kleinschreibung unterschieden. 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.
Weitere Informationen
Befehl „AddResource“
Hinzufügen einer Bindungsdatei zu einer Anwendung
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für