Commande AddResource : script de prétraitement
Pour ajouter un script de prétraitement à une application BizTalk, utilisez la commande AddResource et spécifiez System.BizTalk :PreProcessingScript pour le paramètre Type. L'exécution de cette commande permet d'ajouter le fichier du script à la base de données de gestion BizTalk. Ce fichier s'affiche également dans la console Administration de BizTalk Server, dans le dossier Ressources de l'application pour laquelle vous l'avez ajouté. En outre, le fichier est répertorié lorsque vous utilisez la commande ListApp.
Un script de pré-traitement s'exécute à partir du fichier .msi avant l'importation ou l'installation d'une application ou après sa désinstallation. Vous pouvez également utiliser BTSTask pour ajouter un script de post-traitement, qui s’exécute après l’importation ou l’installation de l’application, ou avant la désinstallation, comme décrit dans Commande AddResource : Script de post-traitement. Pour plus d’informations sur le prétraitement et le post-traitement des scripts, consultez Utilisation de scripts de prétraitement et de post-traitement pour personnaliser le déploiement d’applications.
Utilisation
BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :PreProcessingScript[/Overwrite] /Source :value [/Destination :value] [/Server :value] [/Database :value][/Property :Args="argument list"]
Paramètres
| Paramètre | Obligatoire | Valeur |
|---|---|---|
| /ApplicationName (ou /A, voir Remarques) | No | Nom de l'application BizTalk à laquelle ajouter le script. 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 :PreProcessingScript (cette valeur ne respecte pas la casse.) |
| /Overwrite (ou /O, voir Remarques) | No | Option permettant de mettre à jour un script existant. S’il n’est pas spécifié et qu’il existe déjà un fichier de script dans l’application portant le même nom que le fichier de script ajouté, l’opération d’ajout échoue. |
| /Source (ou /So, voir Remarques) | Yes | Chemin d'accès complet du fichier de script, nom du fichier inclus. S’il existe des espaces dans le chemin, 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 script doit être copié lorsque l'application est installée à partir du fichier .msi. Si ce paramètre n'est pas défini, le fichier n'est pas copié dans le système de fichiers local lors de l'installation. Si ce script doit être exécuté pendant la désinstallation d'une application, vous devez définir le paramètre Destination. À défaut, le script ne sera pas copié dans le système de fichiers local et ne pourra pas être exécuté pendant une désinstallation. S’il existe des espaces dans le chemin, vous devez le placer entre guillemets doubles (« ). |
| /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. |
| /Property (ou /P, voir Remarques) | No | Propriété(s) de ressource transmise(s) au script en tant qu'arguments lorsque le script est appelé. |
Exemple
BTSTask AddResource /ApplicationName :MyApplication /Type : System.BizTalk :PreProcessingScript /Overwrite /Source :"C :\Source Scripts\MyScript.vbs » /Destination :"C :\New Scripts\MyScript.vbs » /Server :MyDatabaseServer /Database :BizTalkMgmtDb /Property :Args="argument1 argument2 »
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é.
Les extensions suivantes sont prises en charge pour les fichiers de script : .com, .exe, .bat, .cmd, .vbs, .vbe, .js, .jse, .wsf, .wsh.
Voir aussi
Commande AddResource
Ajout d'un script de prétraitement ou de post-traitement à une application