Commande AddResource : Assembly BizTalk
Pour ajouter un assembly BizTalk à une application BizTalk, vous utilisez la commande AddResource et spécifiez System.BizTalk :BizTalkAssembly pour le paramètre Type. L'exécution de cette commande ajoute l'assembly à la base de données de gestion BizTalk. Cet assembly s'affiche également dans la console Administration de BizTalk Server, dans le dossier Ressources de l'application à laquelle vous l'avez ajouté. Les artefacts intégrés à l'assembly sont également affichés dans les dossiers appropriés. En outre, les artefacts sont répertoriés lorsque vous utilisez la commande ListApp.
Lors de l'utilisation de cette commande, gardez à l'esprit les points suivants :
Si un assembly porte le même nom complet qu'un assembly existant dans l'application, vous devez spécifier le paramètre Overwrite. À défaut, l'opération correspondant à la commande AddResource échoue. Le nom complet de l'assembly se compose de son nom, d'un jeton de clé publique, de sa culture et de sa version. Si une autre application dépend de cet assembly, l'opération AddResource échoue, que vous spécifiiez ou non le paramètre Overwrite.
Si un autre assembly portant le même nom complet existe dans le groupe, la commande AddResource échoue, que vous spécifiiez ou non le paramètre Overwrite.
Si vous remplacez un assembly qui contient des orchestrations, les orchestrations doivent être arrêtées et désinscrites avant l'exécution de la commande. De même, les ports d'envoi auxquels les orchestrations sont liées doivent être arrêtés et désinscrits, et les emplacements de réception désactivés.
L'opération AddResource échoue également si l'assembly que vous ajoutez dépend d'un artefact qui n'est pas inclus dans l'application.
Pour plus d’informations sur les dépendances, consultez Dépendances et déploiement d’applications.
Utilisation
BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :BizTalkAssembly [/Overwrite] /Source :value [/Destination :value] [/Options :GacOnAdd|GacOnInstall|GacOnImport] [/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. |
| /Type (ou /T, voir Remarques) | Yes | System.BizTalk :BizTalkAssembly (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. Ce nom complet correspond à l'identificateur unique local (LUID) de l'assembly. Vous pouvez afficher les LUID des artefacts dans une application à l’aide de la commande ListApp. Si une autre application dépend de l'assembly qui doit être remplacé, l'opération AddResource échoue, même lorsque ce paramètre est spécifié. |
| /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 ("). Note: Vous pouvez utiliser la variable d’environnement %BTAD_InstallDir%, qui est définie pendant BizTalk Server installation, pour spécifier le dossier d’installation de l’application. Cela permet de créer, pour les fichiers des applications, un emplacement qui est similaire sur les différents ordinateurs de destination. Exemple : « %BTAD_InstallDir%\MyFiles\Orchestrations.dll » |
| /Options (ou /Op, voir Remarques) | No | - GacOnAdd : spécifiez pour installer l’assembly sur le global assembly cache (GAC) sur l’ordinateur local pendant l’opération AddResource. - GacOnInstall : spécifiez d’installer l’assembly sur le GAC lorsque l’application est installée à partir du fichier .msi. - GacOnImport : spécifiez d’installer l’assembly sur le GAC lorsque l’application .msi fichier est importé. Si vous spécifiez plusieurs options, séparez-les par des virgules. |
| /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 vous ne l'indiquez pas, la base de données utilisée est la base de données de gestion BizTalk s'exécutant au sein de l'instance locale de SQL Server. |
Exemple
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
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 BizTalk à une application