Commande AddResource : liaison BizTalk
Pour ajouter un fichier de liaison à une application BizTalk, vous utilisez la commande AddResource et spécifiez System.BizTalk :BizTalkBinding pour le paramètre Type . Lorsque vous ajoutez un fichier de liaison, vous pouvez indiquer un environnement de déploiement en particulier. Lorsque vous importerez ensuite l'application, vous pourrez sélectionner cet environnement de déploiement pour y appliquer les liaisons. Vous pouvez ajouter à une application BizTalk autant de fichiers de liaison que vous le souhaitez et définir un environnement de déploiement différent pour chacun. Pour ajouter plusieurs fichiers de liaison, exécutez la commande AddResource sur chaque fichier à ajouter.
Vous pouvez ajouter un fichier de liaison que vous avez exporté pour un assembly, une application ou un groupe, comme décrit dans ExportBindings Command, puis utiliser la commande AddResource pour ajouter le fichier de liaison à une application.
L'exécution de cette commande entraîne l'ajout du fichier de liaison à la base de données de gestion BizTalk ainsi que l'affichage du fichier dans le dossier Ressources de l'application. En outre, le fichier est répertorié lorsque vous utilisez la commande ListApp. Contrairement à l'importation d'un fichier de liaison, l'ajout d'un tel fichier ne modifie pas immédiatement les liaisons existantes. Les liaisons ne sont pas appliquées tant que l'application n'a pas été importée dans un autre groupe BizTalk.
Lorsque vous ajoutez un fichier de liaison, vous pouvez spécifier son environnement de déploiement à l'aide du paramètre facultatif de la propriété « TargetEnvironment ». La valeur de ce paramètre peut être une chaîne qui représente l'environnement de déploiement dans lequel vous voulez appliquer les liaisons du fichier : « test » ou « production » par exemple. Si vous ne spécifiez pas de valeur pour le paramètre /Property, la valeur <Default> est automatiquement spécifiée et ce fichier de liaison est appliqué chaque fois que l’application est importée.
Lorsque vous importez une application qui comprend un ou plusieurs fichiers de liaison ainsi ajoutés de manière explicite, vous pouvez sélectionner le ou les fichiers de liaison à appliquer en spécifiant la valeur du paramètre de propriété. Les liaisons sont appliquées lors de l'importation de l'application.
À mesure que des liaisons sont appliquées au cours du processus d'importation, les liaisons déjà appliquées sont remplacées par de nouvelles liaisons qui portent le même nom. Autrement dit, la liaison d'un nom donné la plus récente est celle qui est effectivement appliquée. Ayez cela à l'esprit lorsque vous utilisez plusieurs fichiers de liaison. Si les fichiers de liaison contiennent des entrées en double, la liaison prise en compte est celle qui a été appliquée en dernier. Lorsque vous importez une application, les liaisons sont appliquées dans l'ordre suivant :
Liaisons d'application générées par BizTalk Server, n'ayant pas été explicitement ajoutées à l'application au moyen d'un fichier de liaison, mais ayant été sélectionnées par l'utilisateur pour leur exportation dans le fichier .msi de l'application.
Fichiers de liaison ajoutés de manière explicite mais pour lesquels aucun environnement de déploiement cible n'a été défini. À l'intérieur de cet ensemble, l'application des liaisons ne respecte pas d'ordre particulier.
Liaisons ajoutées de manière explicite auxquelles est associé un environnement de déploiement cible correspondant à l'environnement de déploiement sélectionné pour l'importation de l'application. À l'intérieur de cet ensemble, l'application des liaisons ne respecte pas d'ordre particulier.
Pour plus d’informations, consultez Comment importer une application BizTalk. Pour plus d’informations sur l’utilisation des fichiers de liaison, consultez Fichiers de liaison et déploiement d’applications.
Utilisation
BTSTask AddResource [/ApplicationName :"value"] /Type :System.BizTalk :BizTalkBinding/Property :TargetEnvironment="value » [/Overwrite] /Source :value [/Server :value] [/Database :value]
Paramètres
| Paramètre | Obligatoire | Valeur |
|---|---|---|
| /ApplicationName (ou /A, voir Remarques) | No | Nom de l'application BizTalk à laquelle ajouter le fichier de liaison. 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 :BizTalkBinding (cette valeur ne respecte pas la casse.) |
| /Source (ou /So, voir Remarques) | Yes | Chemin d'accès complet du fichier de liaison, nom du fichier inclus. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles ("). |
| /Property :TargetEnvironment= (ou /P :TargetEnvironment=, voir Remarques) | No | Chaîne indiquant l'environnement de déploiement cible. Vous pouvez la chaîne de votre choix (ex. : Production). Exemple : /Property :TargetEnvironment="Production » Si elle n’est pas spécifiée, la valeur Default> est automatiquement appliquée.< La valeur est sensible à la casse. Si elle comprend des espaces, vous devez la placer entre guillemets doubles ("). La longueur maximale de cette valeur ne doit pas dépasser 128 caractères. |
| /Overwrite (ou /Ov, voir Remarques) | No | Option permettant de mettre à jour un fichier de liaison existant. Si cette option n'est pas spécifiée et qu'un fichier de liaison, dont le nom est le même que celui du fichier à ajouter, existe déjà dans l'application, l'opération AddResource échoue. |
| /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 :BizTalkBinding /Property :TargetEnvironment=Test /Source :"C :\Binding Files\MyBinding.xml » /Server :MyDatabaseServer /Database :BizTalkMgmtDb
Remarques
Les noms de propriété respectent la casse. 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
Comment ajouter un fichier de liaison à une application