Énumérer les emplacements de réception (exemple BizTalk Server)
L'exemple d'énumération des emplacements de réception décrit la récupération d'informations détaillées sur un ou plusieurs emplacements de réception.
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 Windows WMI et une version Visual C# qui accède aux objets System.Management fournis par le .NET Framework. En dernier lieu, ces deux versions accèdent au fournisseur WMI de BizTalk Server pour effectuer les opérations suivantes :
requête pour obtenir le jeu d'emplacements de réception configurés ou un emplacement de réception particulier, d'après son nom ;
récupération et affichage des détails concernant chaque emplacement de réception qui vous intéresse ;
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 DE VBScript : <Chemin d’accès> d’exemples\Administration\WMI\Énumérer les emplacements de réception\VBScript\
Version de Visual C# : <Chemin d’accès> des exemples\Administration\WMI\Énumérer les emplacements de réception\CSharp\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| Dans le dossier \VBScript : EnumRecLocs.vbs |
Fichier VBScript qui récupère les détails concernant tous les emplacements de réception configurés. |
| Dans le dossier \CSharp : App.ico, AssemblyInfo.cs, BTSampleEnumerateRLs.csproj, BTSampleEnumerateRLs.sln, EnumRLs.cs |
Fichiers de projet, de solution et sources pour la création d'une application de ligne de commande Visual C# qui récupère les détails sur tous les emplacements de réception configurés ou sur un emplacement de réception particulier. |
Génération et initialisation de cet exemple
La version VBScript de l'exemple d'énumération des emplacements de réception 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'énumération des emplacements de réception
Dans Visual Studio, ouvrez le fichier solution BTSampleEnumerateRLs.sln.
Dans le menu Générer , cliquez sur Générer la solution.
Exécution de cet exemple
Pour exécuter l'exemple d'énumération des emplacements de réception
Dans une fenêtre de commandes, accédez à l'un des dossiers suivants, selon que vous ayez choisi d'exécuter la version VBScript ou Visual C# de cet exemple, respectivement :
<Chemin d’accès> des exemples\Administration\WMI\Énumérer les emplacements de réception\VBScript\
<Chemin d’accès> des exemples\Administration\WMI\Énumérer les emplacements de réception\CSharp\bin\Debug\
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 EnumRecLocs.vbs à l'aide du programme cscript ou le fichier EnumRl.exe. Pour la version Visual C#, exécutez l'un des deux arguments de ligne de commande suivants :
<ReceiveLocationName>. Correspond au nom de l'emplacement de réception pour lequel les détails seront affichés. Si le nom de l'emplacement de réception contient des espaces, placez-le entre guillemets.
/?. Affiche de l’aide.
Par exemple (VBScript) :
cscript EnumRecLocs.vbs- OU - (version Visual C#) :
EnumRl "My Receive Location #3"- OU - (version Visual C#) :
EnumRl /?
Notes
La version VBScript de cet exemple n'accepte aucun paramètre de ligne de commande ; elle est donc uniquement capable de récupérer et d'afficher les détails concernant tous les emplacements de réception.
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 le .NET Framework.
Le fichier de script EnumRecLocs.vbs et le fichier source Visual C# EnumRLs.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.