Commande ImportBindings
Cette commande permet d'importer des liaisons d'un fichier de liaison XML dans une application ou un groupe BizTalk. Les liaisons peuvent avoir été exportées à partir d’un assembly, d’une application ou d’un groupe, comme décrit dans Exportation de liaisons. Les paramètres ApplicationName et GroupLevel n'ont pas les mêmes effets selon l'emplacement à partir duquel les liaisons ont été exportées. Pour plus d'informations, consultez la section « Remarques » plus loin dans cette rubrique.
Notes
Les fichiers de liaison générés dans BizTalk Server n’ont pas d’application spécifiée. Ceux-ci sont donc importés dans l'application par défaut.
Utilisation
BTSTask ImportBindings -Source :value [-GroupLevel-ApplicationName | :value] [-Server :value] [-Database :value] [-ImportTrackingSettings :value] [-ExcludeParties]
Paramètres
| Paramètre | Obligatoire | Valeur |
|---|---|---|
| -Source (ou -So, voir Remarques) | Obligatoire | Chemin d'accès complet du fichier de liaison à importer, nom du fichier inclus. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets ("). |
| -GroupLevel (ou -G, voir Remarques) | Facultatif | Option permettant d'importer le fichier de liaison dans le groupe actuel. Si vous définissez cette option, ne définissez pas le paramètre « ApplicationName ». |
| -ApplicationName (ou -A, voir Remarques) | Facultatif | Nom de l'application BizTalk où les liaisons doivent être importées. Si le nom comprend des espaces, vous devez l’entourer de guillemets doubles (« ). L'application doit exister, faute de quoi, l'opération d'importation échoue. L'application BizTalk par défaut est utilisée si ce paramètre n'est pas spécifié. Si vous définissez ce paramètre, ne définissez pas le paramètre « GroupLevel ». |
| -Server (ou -Se, voir Remarques) | Facultatif | 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 -D, voir Remarques) | Facultatif | 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. |
| -ImportTrackingSettings | Facultatif | Nouveauté à compter de BizTalk Server 2016. Cela remplace l’option d’importation du paramètre de suivi global. Une valeur « true » permet l’importation des paramètres de suivi. False interdit l’importation du paramètre de suivi. |
| -ExcludeParties | Facultatif | Nouveauté à compter de BizTalk Server 2016. Si elle est spécifiée, elle exclut les informations des parties du fichier de liaison. |
Exemple
La commande suivante permet d'importer des liaisons dans l'application appelée MyApplication du groupe BizTalk par défaut.
BTSTask ImportBindings -ApplicationName:MyApplication -Source:C:\Bindings\Binding1.xml
La commande suivante permet d'importer des liaisons dans le groupe défini dans la base de données de gestion BizTalk qui s'exécute sur une instance de SQL Server appelée MY_Server.
BTSTask ImportBindings -GroupLevel -Server:MY_Server -Database:BiztalkMgmtDb -Source:C:\Bindings\Binding1.xml
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é.
Ces liaisons peuvent avoir été exportées depuis un assembly, une application ou un groupe. Les paramètres ApplicationName et GroupLevel n'ont pas les mêmes effets selon l'emplacement à partir duquel les liaisons ont été exportées. Le tableau suivant récapitule ces différents effets.
| Origine des liaisons | Effet avec le paramètre ApplicationName | Effet avec le paramètre GroupLevel |
|---|---|---|
| Liaisons exportées à partir d'un assembly | L'application spécifiée pour le paramètre ApplicationName doit contenir un assembly portant le même nom que l'assembly à partir duquel le fichier de liaison a été exporté, faute de quoi, l'opération d'importation échoue. | Le groupe actuel doit contenir un assembly et une application portant le même nom que l'assembly et l'application à partir desquels le fichier de liaison a été exporté, faute de quoi, l'importation échoue. |
| Liaisons exportées à partir d'une application | L'application à partir de laquelle le fichier de liaison a été exporté doit porter le même nom que l'application indiquée par le paramètre ApplicationName, faute de quoi, l'opération d'importation échoue. | L'application à partir de laquelle le fichier de liaison a été exporté doit porter le même nom qu'une application du groupe dans lequel les liaisons sont importées, faute de quoi, l'opération d'importation échoue. |
| Liaisons exportées à partir d'un groupe | Le groupe à partir duquel le fichier de liaison a été exporté doit inclure une application portant le même nom que l'application indiquée par le paramètre ApplicationName, faute de quoi, l'opération d'importation échoue. | L'importation de liaisons se fait en fonction de correspondances. Autrement dit, les liaisons d'une application faisant partie du groupe à partir duquel les liaisons ont été exportées sont importées dans une application portant le même nom que le groupe actuel. |
Voir aussi
Référence de la ligne de commande BTSTask
Importation des liaisons dans un groupe BizTalk
Importation des liaisons dans une application BizTalk