Freigeben über

Hinzufügen einer BizTalk-Assembly zu einer Anwendung

  • Artikel

In diesem Thema wird erläutert, wie Sie einer Anwendung mithilfe der BizTalk Server-Verwaltungskonsole oder der Befehlszeile eine BizTalk-Assembly hinzufügen.

Beachten Sie beim Hinzufügen der BizTalk-Assembly zu einer Anwendung die folgenden wichtigen Punkte:

  • Geben Sie die Option Überschreiben an, wenn Sie eine Assembly hinzufügen und dabei eine bereits in der Anwendung vorhandene Assembly mit einer LUID (Locally Unique Identifier) überschreiben möchten. Wenn Sie diese Option nicht angeben und in der Anwendung bereits eine Assembly mit derselben LUID wie die hinzugefügte Assembly existiert, schlägt der Vorgang fehl. Die LUID 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.

  • Wenn die Assembly, die Sie hinzufügen, von einem anderen Element abhängt, das nicht in der Anwendung enthalten ist, schlägt das Hinzufügen fehl.

  • Wenn Sie eine BizTalk-Assembly hinzufügen, 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.

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

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 BizTalk-Assembly hinzu

Mithilfe der BizTalk Server-Verwaltungskonsole

  1. Klicken Sie auf Start, auf Alle Programme, auf Microsoft BizTalk Server 20xx und dann auf BizTalk Server Verwaltung.

  2. Erweitern Sie in der Konsolenstruktur BizTalk Server Verwaltung und die BizTalk-Gruppe, die die Anwendung enthält, der Sie die BizTalk-Assembly hinzufügen möchten.

  3. Erweitern Sie Anwendungen und die Anwendung, der Sie eine BizTalk-Assembly hinzufügen möchten.

  4. Klicken Sie mit der rechten Maustaste auf Ressourcen, zeigen Sie auf Hinzufügen , und klicken Sie dann auf BizTalk-Assemblys.

  5. Klicken Sie auf Hinzufügen, wählen Sie die BizTalk-Assemblydatei aus, und klicken Sie dann auf Öffnen.

  6. Geben Sie unter Ziel den vollständigen Pfad des Speicherorts ein, an dem die Assemblydatei kopiert werden soll, wenn die Anwendung aus der .msi-Datei installiert wird, einschließlich des Dateinamens. Bei fehlender Angabe wird die Assemblydatei während der Installation nicht in das lokale Dateisystem kopiert.

  7. Geben Sie unter Optionen die Optionen zum Installieren der BizTalk-Assembly im GAC an, und klicken Sie dann 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:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/Server:value] [/Database:value]

    Beispiel:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalkAssembly /Overwrite /Source:"C:\BizTalk Assemblies\MyOrchestration.dll" /Destination:"C:\New BizTalk Assemblies\ MyOrchestration.dll " /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parameter Wert
    /Applicationname Der Name der BizTalk-Anwendung, der die BizTalk-Assembly 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:BizTalkAssembly
    /Überschreiben Option zum Aktualisieren einer vorhandenen Assembly. Wenn Sie diese Option nicht angeben und in der Anwendung bereits eine Assembly mit der gleichen LUID wie die hinzugefügte Assembly existiert, schlägt der AddResource-Vorgang fehl. Sie können die LUIDs für die Artefakte in einer Anwendung mit dem ListApp-Befehl anzeigen. Wenn eine andere Anwendung von der Assembly, die überschrieben wird, abhängig ist, schlägt der AddResource-Vorgang auch bei Angabe dieses Parameters fehl.
    /Quelle Der vollständige Pfad der Assemblydatei einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /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. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
    /Optionen - GacOnAdd: Geben Sie an, um die Assembly während des AddResource-Vorgangs im globalen Assemblycache (GAC) auf dem lokalen Computer zu installieren.
    - GacOnInstall: Geben Sie an, um die Assembly im GAC zu installieren, wenn die Anwendung aus der .msi-Datei installiert wird.
    - GacOnImport: Geben Sie an, um die Assembly im GAC zu installieren, wenn die Anwendung .msi Datei importiert wird.

    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 BizTalk-Assemblys
Befehl „AddResource“: BizTalk-Assembly