Commande ImportApp

  • Article

Cette commande permet d'importer dans une application BizTalk les artefacts contenus dans un fichier .msi. Si l'application n'existe pas déjà, elle est créée.

Lorsque vous importez une application, vous pouvez utiliser le paramètre /Environment pour spécifier l'environnement cible de déploiement pour l'application si vous lui avez ajouté des fichiers de liaison personnalisés pour un environnement de déploiement particulier. Pour plus d’informations, consultez Liaison de fichiers et déploiement d’applications. Pour obtenir des instructions sur l’ajout de fichiers de liaison, consultez AddResource Command : BizTalk Binding.

Notes

Une opération d'importation expire si elle dépasse 3 600 secondes. Si vous essayez d'importer un fichier .msi et que l'opération arrive à expiration, vous devez diviser le contenu de l'application en plusieurs fichiers .msi en réexportant l'application et en sélectionnant un sous-ensemble d'artefacts à exporter. Pour plus d’informations, consultez Comment exporter une application BizTalk.

Si l'importation échoue, BTSTask retourne le nombre d'erreurs. La plupart des actions entreprises pendant l'opération sont annulées, hormis les actions suivantes :

  • Les actions effectuées par des scripts personnalisés ne sont pas annulées. Vous pouvez écrire vos scripts de manière qu'ils soient annulés à l'aide de la variable d'environnement Delete.

  • Si des assemblys étaient installés dans le Global Assembly Cache (GAC), ils ne sont pas supprimés.

  • Les entrées effectuées dans le registre Windows ne sont pas supprimées.

    Si l'importation réussit, BTSTask retourne « 0 ».

Utilisation

BTSTask ImportApp /Package :value [/Environment :value] [/ApplicationName :value] [/Overwrite] [/Server :value] [/Database :value]

Paramètres

Paramètre Obligatoire Valeur
/Package (ou /P, voir Remarques) Yes Chemin d'accès complet du fichier .msi. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles ("). Exemple : « C :\My MSI Files\MyApplication.msi »
/Environment (ou /E, voir Remarques) No L'environnement cible de déploiement du fichier de liaison à appliquer, tel que Test. Il s'agit de la valeur spécifiée pour l'environnement cible de déploiement lors de l'ajout du fichier de liaison à l'application. Lorsque cette valeur n'est pas indiquée, toutes les liaisons non affectées à un environnement sont appliquées.
/ApplicationName (ou /A, voir Remarques) No Nom de l'application BizTalk dans laquelle les artefacts du fichier .msi sont importés. Si le nom comprend des espaces, vous devez l’entourer de guillemets doubles (« ). Si cette valeur n'est pas définie, l'application par défaut est utilisée. Si l'application spécifiée n'existe pas déjà, elle est créée.
/Overwrite (ou /O, voir Remarques) No Option permettant d'écraser les artefacts de l'application avec ceux du fichier .msi dotés du même identificateur local unique (LUID). Vous pouvez afficher les LUID des artefacts dans une application à l’aide de la commande ListApp. Si cette option n'est pas spécifiée et qu'un ou plusieurs artefacts dans l'application possèdent le même LUID que des artefacts du fichier .msi, l'importation échoue.
/Server (ou /S, 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 /D, 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 ImportApp /Package:C:\MSI\MyApplication.msi /Environment:Test /ApplicationName:MyApplication /Overwrite

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

Référence de la ligne de commande BTSTask
Importer une application BizTalk