Inscrire l’orchestration (exemple BizTalk Server)
L'exemple d'inscription de l'orchestration décrit l'inscription d'une orchestration BizTalk Server dans un hôte.
Avertissement
Les scripts de déploiement devenus inutiles après le déploiement doivent être supprimés. Les scripts d'administration et autres scripts conservés doivent être sécurisés à l'aide de listes de contrôle d'accès et étroitement surveillés.
Fonctions de l'exemple
Cet exemple inclut une version de Visual Basic Scripting Edition (VBScript) qui accède au modèle objet WMI (Windows Management Instrumentation) et une version de Visual C# qui accède aux objets System.Management fournis par .NET Framework. En dernier lieu, ces deux versions accèdent au fournisseur WMI de BizTalk Server pour effectuer les opérations suivantes :
pour un nom d'orchestration et un nom d'assembly, création d'une requête pour une orchestration BizTalk Server déployée spécifique ;
inscription de l'orchestration dans l'hôte par défaut ;
gestion de toutes erreurs de telle sorte que les informations significatives soient renvoyées à l'utilisateur.
Accès à l'exemple
Les exemples se trouvent dans les emplacements du Kit de développement logiciel (SDK) suivants :
Version VBScript : <Chemin d’accès> d’exemples\Administration\WMI\Enlist Orchestration\VBScript\
Version C# visusale : <Chemin d’exemples>\Administration\WMI\Enlist Orchestration\CSharp\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| Dans le dossier \VBScript : EnlistOrch.vbs |
Fichier VBScript qui utilise des paramètres pour spécifier une orchestration à inscrire dans un hôte. |
| Dans le dossier \CSharp : App.ico, AssemblyInfo.cs, BTSampleEnlistOrc.csproj, BTSampleEnlistOrc.sln, EnlistOrc.cs |
Fichiers de projet, de solution et sources pour la création d'une application de ligne de commande Visual C# qui utilise des paramètres pour spécifier une orchestration à inscrire dans un hôte. |
Génération et initialisation de cet exemple
La version VBScript de l'exemple d'inscription de l'orchestration comporte un seul fichier de script Visual Basic, que vous ne devez ni installer ni initialiser.
Pour créer la version Visual C# de l'exemple d'inscription de l'orchestration
Dans Visual Studio, ouvrez le fichier solution BTSampleEnlistOrc.sln.
Dans le menu Générer , cliquez sur Générer une solution.
Pour exécuter l'exemple d'inscription de l'orchestration
Dans une fenêtre de commandes, accédez à l'un des dossiers suivants, selon que vous envisagiez d'exécuter la version VBScript ou Visual C# de cet exemple, respectivement :
<Chemin d’accès> des exemples\Administration\WMI\Enlist Orchestration\VBScript\
<Chemin d’accès> des exemplesAdminWMIEnlist OrchestrationCSharpbinDebug
En fonction de votre choix pour l'exécution de cet exemple (à savoir soit la version VBScript soit la version Visual C#), exécutez respectivement le fichier EnlistOrch.vbs à l'aide du programme cscript ou le fichier EnlistOrc.exe. Dans les deux cas, exécutez les arguments de ligne de commande suivants :
<OrchestrationName>. Nom de l’orchestration à inscrire.
<AssemblyName>. Nom de l’assembly dans lequel l’orchestration a été déployée. Si le nom de l'assembly contient des espaces, placez-le entre guillemets.
Par exemple : (VBScript) :
cscript EnlistOrch.vbs MyBusinessOrchestration "My Business Assembly"- OU - (version Visual C#) :
EnlistOrc MyBusinessOrchestration "My Business Assembly"
Commentaires
Toutes les tâches que vous pouvez effectuer dans la console d’administration BizTalk Server peuvent également être effectuées à l’aide d’un script qui accède au modèle objet Windows WMI et à l’aide de Visual C# qui accède aux objets System.Management fournis par .NET Framework.
Le fichier de script EnlistOrch.vbs et le fichier source Visual C# EnlistOrc.cs contiennent des commentaires détaillés avec des explications plus précises sur les opérations qu'ils exécutent. Pour plus d’informations, consultez Windows Management Instrumentation.