AddResource-Befehl: .NET-Assembly
Um einer BizTalk-Anwendung eine .NET-Assembly (einschließlich verwalteter COM- oder COM+-Komponenten) hinzuzufügen, verwenden Sie den Befehl AddResource und geben System.BizTalk:Assembly für den Type-Parameter an. Mit diesem Befehl fügen Sie die Assembly der BizTalk-Verwaltungsdatenbank hinzu. Die Assembly wird außerdem in der BizTalk-Verwaltungskonsole angezeigt, und zwar im Ressourcenordner der Anwendung, der Sie sie hinzugefügt haben. Darüber hinaus wird die Assembly aufgeführt, wenn Sie den ListApp-Befehl verwenden.
Wenn der vollständige Name einer Assembly mit dem einer Assembly übereinstimmt, die bereits in der Anwendung vorhanden ist, können Sie den Parameter "Overwrite" angeben. Der vollständige Name setzt sich zusammen aus dem Namen, dem öffentlichen Schlüsseltoken, der Kultur und der Version. In diesem Fall wird die vorhandene Assembly überschrieben. Weitere Informationen zu Abhängigkeiten finden Sie unter Abhängigkeiten und Anwendungsbereitstellung.
Verbrauch
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly[/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]
Parameter
| Parameter | Erforderlich | Wert |
|---|---|---|
| /ApplicationName (oder /A, siehe Hinweise) | No | Der Name der BizTalk-Anwendung, der die Assembly hinzugefügt werden soll. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen. Wenn der Anwendungsname nicht angegeben ist, wird die BizTalk-Standardanwendung für die Gruppe verwendet. |
| /Type (oder /T, siehe Hinweise) | Yes | System.BizTalk:Assembly (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.) |
| /Überschreiben (oder /Ov, siehe Hinweise) | No | 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 zusammen aus dem Assemblynamen, der Version, der Kultur und dem öffentlichen Schlüsseltoken. Diese Informationen werden im Feld "Name" des Ressourcenordners der Anwendung in der BizTalk Server-Verwaltungskonsole angezeigt. |
| /Source (oder /So, siehe Hinweise) | Yes | 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. |
| /Destination (oder /De, siehe Hinweise) | No | 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 mit doppelten Anführungszeichen (") einschließen. Bei Angabe der Option "RegasmOnInstall" oder "RegsvcsOnInstall" müssen Sie auch den Parameter "Destination" festlegen. Hinweis: Sie können die Umgebungsvariable %BTAD_InstallDir% verwenden, um den Anwendungsinstallationsordner anzugeben. Dadurch wird ein konsistenter Speicherort für die Dateien der Anwendung auf verschiedenen Zielcomputern erstellt. Beispiel: "%BTAD_InstallDir%\MyAssemblies\Orchestrations.dll" |
| /Options (oder /Op, siehe Hinweise) | No | - 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. Zwischen Kommas und Werten dürfen sich keine Leerzeichen befinden. |
| /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:Assembly /Overwrite /Source:"%BTAD_InstallDir%\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb
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.
Weitere Informationen
Befehl „AddResource“
Hinzufügen einer .NET-Assembly zu einer Anwendung