Freigeben über

Befehl „AddResource“: BizTalk-Assembly

  • Artikel

Um einer BizTalk-Anwendung eine BizTalk-Assembly hinzuzufügen, verwenden Sie den Befehl AddResource , und geben Sie System.BizTalk:BizTalkAssembly 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 Server-Verwaltungskonsole angezeigt, und zwar im Ressourcenordner der Anwendung, der sie hinzugefügt wurde. Die in der Assembly enthaltenen Elemente werden außerdem in den entsprechenden Ordnern angezeigt. Darüber hinaus werden die Artefakte aufgelistet, wenn Sie den ListApp-Befehl verwenden.

Bei Verwendung dieses Befehls sollten Sie die folgenden Punkte beachten:

  • Wenn der vollständige Name der Assembly mit dem Namen einer Assembly übereinstimmt, die bereits in der Anwendung vorhanden ist, müssen Sie den Parameter "Overwrite" angeben. Andernfalls schlägt der AddResource-Vorgang fehl. Der vollständige Name setzt sich zusammen aus dem Namen, dem öffentlichen Schlüsseltoken, der Kultur und der Version. Wenn jedoch eine andere Anwendung von dieser Assembly abhängig ist, schlägt der AddResource-Vorgang auch bei Angabe des Parameters "Overwrite" fehl.

  • Wenn die Gruppe eine andere Assembly mit demselben vollständigen Namen enthält, schlägt der AddResource-Vorgang auch bei Angabe des Parameters "Overwrite" fehl.

  • Wenn Sie eine Assembly überschreiben, die Orchestrierungen enthält, müssen die Orchestrierungen vor der Ausführung dieses Befehls angehalten und ausgetragen werden. Außerdem müssen Sie die Sendeports, an die die Orchestrierung gebunden ist, anhalten und austragen, sowie die Empfangsspeicherorte deaktivieren.

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

    Weitere Informationen zu Abhängigkeiten finden Sie unter Abhängigkeiten und Anwendungsbereitstellung.

Verbrauch

BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/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 wurde, wird die BizTalk-Standardanwendung verwendet.
/Type (oder /T, siehe Hinweise) Yes System.BizTalk:BizTalkAssembly (Bei diesem Wert wird nicht zwischen Groß-/Kleinschreibung unterschieden.)
/Overwrite (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 entspricht dem LUID (Locally Unique Identifier) für die Assembly. Sie können die LUIDs für die Artefakte in einer Anwendung anzeigen, indem Sie den ListApp-Befehl verwenden. Wenn eine andere Anwendung von der Assembly, die überschrieben wird, abhängig ist, schlägt der AddResource-Vorgang auch bei Angabe dieses Parameters fehl.
/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 in doppelte Anführungszeichen (") setzen.
/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 in doppelte Anführungszeichen (") setzen. Hinweis: Sie können die Umgebungsvariable %BTAD_InstallDir% verwenden, die während BizTalk Server Installation festgelegt wird, um den Anwendungsinstallationsordner anzugeben. Dadurch wird ein einheitlicher Speicherort für die Dateien der Anwendung auf verschiedenen Zielcomputern festgelegt. Beispiel: "%BTAD_InstallDir%\MyFiles\Orchestrations.dll"
/Options (oder /Op, siehe Hinweise) No - 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 (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. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

Beispiel

BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite

/Source:"%BTAD_InstallDir%\Source Assemblies\Orchestrations.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\Orchestrations.dll" /Options:GacOnInstall,GacOnImport /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 BizTalk-Assembly zu einer Anwendung