So fügen Sie einer Anwendung eine .NET-Assembly hinzu

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

• Wenn Sie eine Assembly überschreiben möchten, die bereits in der Anwendung vorhanden ist, geben Sie die Option "Überschreiben" an. Die Option "Überschreiben" ist nur erforderlich, wenn beide Assemblys dieselbe LUID aufweisen. Wenn sie nicht angegeben ist und in der Anwendung bereits eine Assembly mit derselben LUID wie die hinzugefügte Assembly vorhanden ist, schlägt der Add-Vorgang fehl. Sie können die LUIDs für die Artefakte in einer Anwendung mithilfe des ListApp-Befehls anzeigen.

• Wenn Sie eine .NET-Assembly hinzufügen, können Sie eine oder mehrere der folgenden Optionen für die Installation der Assembly im globalen Assemblycache (GAC) angeben:

  • Zum globalen Assemblycache beim Hinzufügen einer Ressource (gacutil) hinzufügen. Wenn Sie diese Option auswählen, wird die Assembly im GAC auf dem lokalen Computer installiert, wenn die Assembly zu einer Anwendung hinzugefügt wird, als Ergebnis der Verwendung der Verfahren in diesem Thema.

  • Fügen Sie zum globalen Assemblycache beim MSI-Dateiimport (gacutil) hinzu. Wenn Sie diese Option auswählen, wird die Anwendung in eine .msi Datei exportiert und die .msi Datei in eine BizTalk-Gruppe importiert, die Assembly wird im GAC auf dem lokalen Computer im Rahmen des Importvorgangs installiert. Wählen Sie diese Option aus, wenn Ihre Anwendung eine Richtlinie sowie eine Assembly enthält, von der die Richtlinie abhängt. Dazu müssen Sie vorgehen, da beim Importieren einer Anwendung, die eine Richtlinie enthält, alle Assemblys, von denen die Richtlinie abhängt, im GAC vorhanden sein müssen.

  • Fügen Sie den Global Assembly Cache bei der Installation von MSI-Dateien hinzu (gacutil). Wenn Sie diese Option auswählen, wenn die Anwendung in eine .msi-Datei exportiert wird und die Anwendung auf einem Computer aus der .msi-Datei installiert ist, wird die Assembly im GAC auf dem lokalen Computer im Rahmen des Installationsprozesses installiert.

  • Für COM-Komponenten sichtbar machen (Regasm). Wenn Sie diese Option auswählen, wird, wenn die Anwendung in eine .msi Datei exportiert wird und die Anwendung auf einem Computer aus der .msi-Datei installiert ist, eine verwaltete COM-Assembly im Rahmen des Installationsprozesses zur Windows-Registrierung auf dem lokalen Computer hinzugefügt. Wenn Sie diese Option angeben, müssen Sie auch einen Speicherort für die Datei im Ziel angeben.

  • Registrieren von verwalteten Komponenten (regsvcs). Wenn Sie diese Option auswählen, wird, wenn die Anwendung in eine .msi Datei exportiert wird und die Anwendung auf einem Computer aus der .msi Datei installiert ist, eine verwaltete COM+-Assembly im Rahmen des Installationsprozesses zur Windows-Registrierung auf dem lokalen Computer hinzugefügt. Wenn Sie diese Option angeben, müssen Sie auch einen Speicherort für die Datei im Ziel angeben.

Voraussetzungen

Um die Verfahren in diesem Thema auszuführen, 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 zum Bereitstellen und Verwalten einer BizTalk-Anwendung".

So fügen Sie einer Anwendung eine .NET-Assembly hinzu

Verwenden der BizTalk Server-Verwaltungskonsole

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

2. Erweitern Sie in der Konsolenstruktur die BizTalk Server-Verwaltung, erweitern Sie die BizTalk-Gruppe, erweitern Sie Anwendungen, und erweitern Sie dann die Anwendung, der Sie die .NET-Assembly hinzufügen möchten.

3. Klicken Sie mit der rechten Maustaste auf den Ordner "Ressourcen ", zeigen Sie auf "Hinzufügen", und klicken Sie dann auf "Ressourcen".

4. Klicken Sie auf "Hinzufügen", klicken Sie auf die Assembly, und klicken Sie dann auf "Öffnen".

5. Wählen Sie in der Dropdownliste " Dateityp " " System.BizTalk:Assembly" aus.

6. Wählen Sie unter "Optionen" die Bereitstellungsoptionen für diese Assembly aus.

7. Geben Sie im 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. Wenn dieser Pfad nicht angegeben wird, wird die Datei während der Installation nicht in das lokale Dateisystem kopiert. Um die Datei in den Anwendungsinstallationsordner zu kopieren, können Sie die umgebungsvariable %BTAD_InstallDir% im Pfad verwenden, der den Wert des Anwendungsinstallationsordners verwendet, wenn die Anwendung installiert wird. Auf diese Weise müssen Sie den Pfad des Anwendungsinstallationsordners nicht kennen, wenn Sie den Zielspeicherort angeben.

   Beispiel: %BTADInstall_Dir%\Assemblies\Orchestrations.dll

8. Klicken Sie auf die Registerkarte "Abhängigkeiten ", und zeigen Sie die Artefakte an, von denen diese Assembly abhängt.

9. 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 "Zu Anwendung hinzufügen", navigieren Sie zum Artefakt, und klicken Sie dann auf "Öffnen".

10. Klicken Sie abschließend auf OK.

Verwenden der Befehlszeile

1. Öffnen Sie eine Eingabeaufforderung wie folgt: Klicken Sie auf "Start", klicken Sie auf "Ausführen", geben cmdSie den Befehl ein, 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: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, zu welcher 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 (") einschließen.
   /Art	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 in der Anwendung bereits eine Assembly vorhanden ist, die denselben vollständigen Namen wie die hinzugefügte Assembly aufweist, schlägt der AddResource-Vorgang fehl. Der vollständige Name enthält den Assemblydateinamen, die Version, die Kultur und das öffentliche Schlüsseltoken. Sie können die LUIDs für die Artefakte in einer Anwendung mithilfe des ListApp-Befehls anzeigen.
   /Quelle	Vollständiger Pfad der Assemblydatei, einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn mit doppelten Anführungszeichen (") einschließen.
   /Bestimmungsort	Vollständiger Pfad des Speicherorts, an dem die Assemblydatei kopiert werden soll, wenn die Anwendung aus der datei .msi installiert wird. Falls nicht angegeben, wird die Assemblydatei während der Installation nicht in das lokale Dateisystem kopiert. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn mit doppelten Anführungszeichen (") einschließen. Wenn Sie die Option "RegasmOnInstall" oder "RegsvcsOnInstall" angeben, müssen Sie auch "Destination" angeben. Anmerkung: Sie können die %BTAD_InstallDir% Umgebungsvariable im Pfad verwenden. Es nimmt den Wert des Anwendungsinstallationsordners an, wenn die Anwendung installiert wird. Auf diese Weise müssen Sie den Pfad des Anwendungsinstallationsordners nicht kennen, wenn Sie den Zielspeicherort angeben. 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 auf dem GAC, wenn die Anwendung aus der datei .msi 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 das Ziel angeben. - RegsvcsOnInstall:Fügen Sie eine verwaltete COM+-Assembly zur Windows-Registrierung hinzu, wenn die Anwendung aus der .msi-Datei installiert wird. Wenn Sie diese Option angeben, müssen Sie auch das Ziel angeben. Sie müssen mehrere Optionen durch ein Komma trennen.
   /Server	Name der SQL Server-Instanz, die die BizTalk Management-Datenbank hosten, im Format ServerName\InstanceName,Port. Der Instanzname ist nur erforderlich, wenn sich der Instanzname von dem Servernamen unterscheidet. Port ist nur erforderlich, wenn SQL Server eine andere Portnummer als die Standardnummer verwendet (1433). Beispiele Server=MyServer Server=MyServer\MySQLServer,1533 Falls nicht angegeben, wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
   /Datenbank	Name der BizTalk-Verwaltungsdatenbank. Wenn nicht angegeben, wird die BizTalk Management-Datenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

Siehe auch

Verwalten von .NET-Assemblys, Zertifikaten und anderen Ressourcen
AddResource-Befehl: .NET-Assembly
Erstellen und Ändern von BizTalk-Anwendungen