Hinzufügen einer .NET-Assembly zu einer Anwendung

Artikel
07/21/2023

In diesem Thema wird beschrieben, wie Sie mithilfe der BizTalk Server-Verwaltungskonsole oder der Befehlszeile einer BizTalk-Anwendung eine .NET-Assembly, die keine BizTalk-Assembly ist, hinzufügen. Beachten Sie beim Hinzufügen der .NET-Assembly zu einer Anwendung die folgenden wichtigen Punkte:

Wenn Sie eine in der Anwendung bereits vorhandene Assembly überschreiben möchten, müssen Sie die Option zum Überschreiben angeben. Die Option zum Überschreiben wird nur benötigt, wenn beide Assemblys dieselbe LUID aufweisen. Wenn Sie diese Option nicht angeben und in der Anwendung bereits eine Assembly mit derselben LUID vorhanden ist, die auch die hinzugefügte Assembly hat, schlägt das Hinzufügen fehl. Sie können die LUIDs für die Artefakte in einer Anwendung mit dem ListApp-Befehl anzeigen.
Beim Hinzufügen einer .NET-Assembly können Sie eine oder mehrere der folgenden Optionen zum Installieren der Assembly im globalen Assemblycache (GAC) angeben:
- Beim Hinzufügen der Ressource zum globalen Assemblycache hinzufügen (gacutil). Wenn Sie diese Option auswählen, wird die Assembly beim Hinzufügen der Assembly zu einer Anwendung aufgrund der in diesem Thema beschriebenen Verfahren im GAC des lokalen Computers installiert.
- Beim Importieren der MSI-Datei zum globalen Assemblycache hinzufügen (gacutil). Wenn Sie diese Option auswählen, wird die Assembly beim Importieren der in eine MSI-Datei exportierten Anwendung in eine BizTalk-Gruppe während des Importvorgangs im GAC des lokalen Computers installiert. Wählen Sie diese Option aus, wenn Ihre Anwendung eine Richtlinie und eine Assembly enthält, von der die Richtlinie abhängig ist. Dies ist erforderlich, da beim Importieren einer Anwendung, die eine Richtlinie enthält, alle Assemblys, von der die Richtlinie abhängig ist, im GAC vorhanden sein müssen.
- Beim Installieren der MSI-Datei dem globalen Assemblycache hinzufügen (gacutil). Wenn Sie diese Option auswählen, wird die Assembly beim Installieren der in eine MSI-Datei exportierten Anwendung auf einem Computer während der Installation im GAC des lokalen Computers installiert.
- Für COM-Komponenten sichtbar machen (regasm). Wenn Sie diese Option auswählen, wird beim Installieren der in eine MSI-Datei exportierten Anwendung auf einem Computer während der Installation der Windows-Registrierung eine verwaltete COM-Assembly hinzugefügt. Wenn Sie diese Option auswählen, müssen Sie auch einen Zielspeicherort für die Datei angeben.
- Verarbeitete Komponenten registrieren (regsvcs). Wenn Sie diese Option auswählen, wird beim Installieren der in eine MSI-Datei exportierten Anwendung auf einem Computer während der Installation der Windows-Registrierung eine verwaltete COM+-Assembly hinzugefügt. Wenn Sie diese Option auswählen, müssen Sie auch einen Zielspeicherort für die Datei angeben.

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 eine .NET-Assembly hinzu

Mithilfe der BizTalk Server-Verwaltungskonsole

Klicken Sie auf Start, auf Alle Programme, auf Microsoft BizTalk Server 20xx und dann auf BizTalk Server Verwaltung.
Erweitern Sie in der Konsolenstruktur BizTalk Server Administration, die BizTalk-Gruppe, anwendungen und dann die Anwendung, der Sie die .NET-Assembly hinzufügen möchten.
Klicken Sie mit der rechten Maustaste auf den Ordner Ressourcen , zeigen Sie auf Hinzufügen, und klicken Sie dann auf Ressourcen.
Klicken Sie auf Hinzufügen, klicken Sie auf die Assembly, und klicken Sie dann auf Öffnen.
Wählen Sie in der Dropdownliste Dateityp die Option System.BizTalk:Assembly aus.
Wählen Sie unter Optionen die Bereitstellungsoptionen für diese Assembly aus.
Geben Sie unter Ziel den vollständigen Pfad des Speicherorts ein, an dem die Datei kopiert werden soll, wenn die Anwendung aus der .msi-Datei installiert wird, einschließlich des Dateinamens. Bei fehlender Angabe dieses Pfades wird die Datei während der Installation nicht in das lokale Dateisystem kopiert. Sie können in dem Pfad, der bei der Installation den Wert des Installationsordners der Anwendung annimmt, die Umgebungsvariable %BTAD_InstallDir% verwenden, um die Datei in den Installationsordner der Anwendung zu kopieren. Auf diese Weise müssen Sie den Pfad des Installationsordners der Anwendung beim Festlegen des Zielspeicherorts nicht kennen.

Beispiel: %BTADInstall_Dir%\Assemblies\Orchestrations.dll
Klicken Sie auf die Registerkarte Abhängigkeiten , und zeigen Sie die Artefakte an, von denen diese Assembly abhängt.
Wenn ein Artefakt, von dem diese Assembly abhängt, in dieser Anwendung nicht vorhanden ist und Sie es hinzufügen möchten, klicken Sie auf Zur Anwendung hinzufügen, navigieren Sie zum Artefakt, und klicken Sie dann auf Öffnen.
Wenn Sie fertig sind, klicken Sie auf OK.

Verwenden der Befehlszeile

Ö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.

Geben Sie folgenden Befehl ein. Setzen Sie dabei die entsprechenden Werte ein, wie in der folgenden Tabelle beschrieben:

BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]

Beispiel:

BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Assembly /Overwrite /Source:"C:\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

Parameter	Wert
/Applicationname	Der Name der BizTalk-Anwendung, der die Assembly 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:Assembly (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.)
/Überschreiben	Option zum Aktualisieren einer vorhandenen Assembly. Wenn sie nicht angegeben ist, und wenn in der Anwendung bereits eine Assembly existiert, deren vollständiger Name mit dem der hinzugefügten Assembly übereinstimmt, schlägt der AddResource-Vorgang fehl. Der vollständige Name setzt sich aus dem Assemblydateinamen, der Version, der Kultur und dem öffentlichen Schlüsseltoken zusammen. Sie können die LUIDs für die Artefakte in einer Anwendung mit dem ListApp-Befehl anzeigen.
/Quelle	Der vollständige Pfad der Assemblydatei einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn mit doppelten Anführungszeichen (") einschließen.
/Ziel	Der vollständige Pfad des Speicherorts, an den die Assemblydatei bei Installation der Anwendung mithilfe der MSI-Datei kopiert werden soll. Bei fehlender Angabe wird die Assemblydatei während der Installation nicht in das lokale Dateisystem kopiert. Enthält der Pfad Leerzeichen, müssen Sie ihn in doppelte Anführungszeichen (") setzen. Bei Angabe der Option "RegasmOnInstall" oder "RegsvcsOnInstall" müssen Sie auch den Parameter "Destination" festlegen. Hinweis: Sie können die Umgebungsvariable %BTAD_InstallDir% im Pfad verwenden. Sie nimmt bei der Installation den Wert des Installationsordners der Anwendung an. Auf diese Weise müssen Sie den Pfad des Installationsordners der Anwendung beim Festlegen des Zielspeicherorts nicht kennen. Beispiel: %BTAD_InstallDir%\Assemblies\Orchestrations.dll
/Optionen	- GacOnAdd: Installieren Sie die Assembly im globalen Assemblycache (GAC) auf dem lokalen Computer während des AddResource-Vorgangs. - GacOnInstall: Installieren Sie die Assembly im GAC, wenn die Anwendung aus der .msi-Datei installiert wird. - GacOnImport: Installieren Sie die Assembly im GAC, wenn die Anwendung .msi Datei importiert wird. - RegasmOnInstall: Fügen Sie der Windows-Registrierung eine verwaltete COM-Assembly hinzu, wenn die Anwendung aus der .msi-Datei installiert wird. Wenn Sie diese Option angeben, müssen Sie auch den Parameter "Destination" festlegen. - RegsvcsOnInstall:Fügen Sie der Windows-Registrierung eine verwaltete COM+-Assembly hinzu, wenn die Anwendung aus der .msi-Datei installiert wird. Wenn Sie diese Option angeben, müssen Sie auch den Parameter "Destination" festlegen. Bei Angabe mehrerer Optionen müssen Sie die Optionen mit Kommas trennen.
/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
AddResource-Befehl: .NET-Assembly
Erstellen und Bearbeiten von BizTalk-Anwendungen

Freigeben über