Commande AddResource : assembly .NET
Pour ajouter un assembly .NET (qui inclut des composants COM ou COM+ managés) à une application BizTalk, utilisez la commande AddResource et spécifiez System.BizTalk :Assembly pour le paramètre Type. L'exécution de cette commande ajoute l'assembly à la base de données de gestion BizTalk. L'assembly s'affiche également dans la console Administration de BizTalk Server, dans le dossier Ressources de l'application à laquelle vous l'avez ajouté. En outre, l’assembly est répertorié lorsque vous utilisez la commande ListApp.
Si un assembly porte le même nom complet qu'un assembly existant dans l'application, vous pouvez spécifier le paramètre Overwrite. Le nom complet de l'assembly se compose de son nom, d'un jeton de clé publique, de sa culture et de sa version. Dans ce cas, l'assembly existant est remplacé. Pour plus d’informations sur les dépendances, consultez Dépendances et déploiement d’applications.
Utilisation
BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :Assembly[/Overwrite] /Source :value [/Destination :value] [/Options :GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server :value] [/Database :value]
Paramètres
| Paramètre | Obligatoire | Valeur |
|---|---|---|
| /ApplicationName (ou /A, voir Remarques) | No | Nom de l'application BizTalk à laquelle ajouter l'assembly. Si le nom comprend des espaces, vous devez le placer entre guillemets doubles (« ). Si le nom de l'application n'est pas spécifié, l'application utilisée est l'application BizTalk définie par défaut pour le groupe. |
| /Type (ou /T, voir Remarques) | Yes | System.BizTalk :Assembly (cette valeur ne respecte pas la casse.) |
| /Overwrite (ou /Ov, voir Remarques) | No | Option permettant de mettre à jour un assembly existant. Si cette option n'est pas spécifiée et qu'un assembly, dont le nom complet est le même que celui de l'assembly à ajouter, existe déjà dans l'application, l'opération AddResource échoue. Le nom complet inclut le nom de l’assembly, la version, la culture et le jeton de clé publique. Cette information s'affiche dans le champ Nom du dossier Ressources de l'application dans la console Administration de BizTalk Server. |
| /Source (ou /So, voir Remarques) | Yes | Chemin d'accès complet du fichier de l'assembly, nom du fichier inclus. Si le chemin d’accès comprend des espaces, vous devez le placer entre guillemets doubles (« ). |
| /Destination (ou /De, voir remarques) | No | Chemin d'accès complet de l'emplacement où le fichier de l'assembly doit être copié lorsque l'application est installée à partir du fichier .msi. S’il n’est pas fourni, le fichier d’assembly n’est pas copié dans le système de fichiers local pendant l’installation. Si le chemin d’accès comprend des espaces, vous devez le placer entre guillemets doubles (« ). Si vous spécifiez l'option RegasmOnInstall ou RegsvcsOnInstall, vous devez également spécifier Destination. Note: Vous pouvez utiliser la variable d’environnement %BTAD_InstallDir% pour spécifier le dossier d’installation de l’application. Cela crée un emplacement cohérent pour les fichiers de l’application sur différents ordinateurs de destination. Exemple : « %BTAD_InstallDir%\MyAssemblies\Orchestrations.dll » |
| /Options (ou /Op, voir Remarques) | No | - GacOnAdd : installez l’assembly dans le Global Assembly Cache (GAC) sur l’ordinateur local pendant l’opération AddResource. - GacOnInstall : installez l’assembly dans le GAC lorsque l’application est installée à partir du fichier .msi. - GacOnImport : installez l’assembly dans le GAC lorsque le fichier .msi de l’application est importé. - RegasmOnInstall : ajoutez un assembly COM managé au Registre Windows lorsque l’application est installée à partir du fichier .msi. Si vous définissez cette option, vous devez également définir le paramètre Destination. - RegsvcsOnInstall : Ajoutez un assembly COM+ managé au Registre Windows lorsque l’application est installée à partir du fichier .msi. Si vous définissez cette option, vous devez également définir le paramètre Destination. Si vous spécifiez plusieurs options, séparez-les par des virgules. Aucun espace n'est autorisé entre les virgules et les valeurs. |
| /Server (ou /Se, voir Remarques) | No | Nom de l'instance SQL Server hébergeant la base de données de gestion BizTalk et indiqué sous la forme NomServeur\NomInstance,Port. Le nom de l'instance est uniquement requis lorsqu'il est différent du nom du serveur. Le port est uniquement requis lorsque le serveur SQL Server utilise un numéro de port autre que celui par défaut (1433). Exemples : Server=MyServer Server=MyServer\MySQLServer,1533 Si vous n'indiquez pas de nom pour l'instance SQL Server, le nom d'instance utilisé est celui de l'instance SQL Server exécutée sur l'ordinateur local. |
| /Database (ou /Da, voir Remarques) | No | Nom de la base de données de gestion BizTalk. Si elle n’est pas fournie, la base de données de gestion BizTalk s’exécutant dans la instance locale de SQL Server est utilisée. |
Exemple
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
Remarques
Les paramètres ne respectent pas la casse. Il n'est pas nécessaire de taper le nom complet du paramètre pour l'indiquer. Vous pouvez vous contenter de taper les premières lettres du nom à condition qu'elles suffisent à identifier le paramètre sans ambiguïté.
Voir aussi
Commande AddResource
Ajout d'un assembly .NET à une application