Outil Éditeur de configuration (SvcConfigEditor.exe)

L'Éditeur de configuration de service (SvcConfigEditor.exe) Windows Communication Fondation (WCF) permet aux administrateurs et aux développeurs de créer et de modifier les paramètres de configuration pour les services WCF à l'aide d'une interface utilisateur graphique (GUI). Grâce à cet outil, vous pouvez gérer les paramètres des liaisons, des comportements, des services et des diagnostics WCF sans modifier directement les fichiers de configuration XML.

L’Éditeur de configuration de service se trouve dans le dossier C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.

Éditeur de configuration WCF

L'Éditeur de configuration de service est fourni avec un Assistant qui vous guide à travers toutes les étapes de configuration d'un service ou d'un client WCF. Il est vivement recommandé d'utiliser l'Assistant au lieu d'utiliser directement l'éditeur.

Si vous avez déjà quelques fichiers de configuration conformes au schéma System.Configuration standard, vous pouvez gérer des paramètres spécifiques pour les liaisons, comportements, services et diagnostics avec l’interface utilisateur. L'Éditeur de configuration de service permet de gérer les paramètres des fichiers de configuration WCF existants, ainsi que les fichiers exécutables, les services COM+ et les services hébergés sur le Web. Lorsque vous ouvrez un service hébergé sur le Web au moyen de l'Éditeur de configuration de service, vous accédez à la propre configuration du service et aux sections de configurations héritées des nœuds de niveau supérieur.

Les paramètres de configuration WCF figurent dans la section <system.serviceModel> du fichier de configuration ; par conséquent, l'éditeur fonctionne exclusivement sur le contenu de cet élément et n'accède pas à d'autres éléments du même fichier. Vous pouvez naviguer directement jusqu'aux fichiers de configuration existants ou vous pouvez sélectionner un assembly qui contient un service, un répertoire virtuel ou un service COM+. L'éditeur charge le fichier de configuration pour ce service particulier et autorise l'utilisateur à ajouter des nouveaux éléments ou à modifier des éléments existants imbriqués dans la section <system.serviceModel> du fichier de configuration.

L'éditeur prend en charge IntelliSense et applique la conformité de schéma. Le résultat est conformer au schéma du fichier de configuration et possède des valeurs de données correctes syntaxiquement. Toutefois, l'éditeur ne garantit pas que le fichier de configuration soit correct sur un plan sémantique. En d'autres termes, l'éditeur ne garantit pas que le fichier de configuration puisse fonctionner avec le service qu'il configure.

Utilisation de l'Éditeur de configuration

L'Éditeur de configuration de service se trouve à l'emplacement d'installation du Kit de développement logiciel (SDK) Windows suivant :

C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe

Après avoir lancé l’Éditeur de configuration de service, vous pouvez utiliser le menu Fichier/Ouvrir pour rechercher le service ou l’assembly à gérer. Vous pouvez ouvrir des fichiers de configuration directement, rechercher des services WCF/COM + et ouvrir des fichiers de configuration pour des services hébergés par le Web.

L'interface utilisateur de l'Éditeur de configuration de service est divisée dans les zones suivantes :

• Volet (arborescence) qui affiche les éléments de configuration sous forme d’arborescence à gauche. Vous pouvez exécuter des opérations dans l'arbre en cliquant avec le bouton droit sur les nœuds.

• Volet de tâches qui présente les tâches courantes applicables aux éléments actuels dans la partie inférieure gauche de la fenêtre.

• Volet Détail qui affiche les paramètres détaillés du nœud de configuration sélectionné dans l’arborescence à droite.

Ouverture d'un fichier de configuration

1. Démarrez l’Éditeur de configuration de service en utilisant une fenêtre de commande pour accéder à votre emplacement d’installation WCF, puis tapez SvcConfigEditor.exe.

2. Dans le menu Fichier, sélectionnez Ouvrir et cliquez sur le type de fichier que vous souhaitez gérer.

3. Dans la boîte de dialogue Ouvrir, naviguez jusqu’au fichier spécifique que vous souhaitez gérer et double-cliquez dessus.

La visionneuse suit automatiquement le chemin d’accès de fusion de la configuration et crée une vue de la configuration fusionnée. Par exemple, la configuration réelle d’un service non hébergé est une combinaison de Machine.config et App.config. Toutes les modifications sont appliquées au fichier actif dans SvcConfigEditor. Si vous souhaitez modifier un fichier spécifique dans le chemin d’accès de fusion de la configuration, vous devez l’ouvrir directement.

Services

Le nœud Services affiche tous les services assignés actuellement dans le fichier de configuration. Chaque sous-nœud dans l’arbre correspond à un sous-élément de l’élément <services> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Services, vous pouvez afficher ou exécuter des tâches dans la page Résumé, dans le volet Détail.

Création d'une configuration de service

Vous pouvez créer une configuration de service de l'une des manières suivantes :

• À l’aide d’un Assistant : cliquez sur le lien Créer un service dans le volet des tâches ou la page Résumé pour lancer l’Assistant. Vous pouvez également le faire dans le menu Fichier ->Ajouter un nouvel élément.

• Manuellement : vous pouvez cliquer avec le bouton droit sur le nœud Services et choisir Nouveau service.

Création d'une configuration de point de terminaison de service

Vous pouvez créer une nouvelle configuration de point de terminaison de service de l'une des manières suivantes :

• Création à l’aide d’un Assistant : cliquez sur le lien Créer un point de terminaison de service dans le volet des tâches ou la page Résumé pour lancer l’Assistant. Vous pouvez également le faire dans le menu Fichier ->Ajouter un nouvel élément.

• Manuellement : une fois que vous avez créé un service, vous pouvez cliquer avec le bouton droit sur le nœud Points de terminaison et choisir Nouveau point de terminaison de service.

Modification d'une configuration de service

1. Cliquez sur un nœud Service.

2. Modifiez les paramètres dans les grilles de propriété.

Modification d'une configuration de points de terminaison de service

1. Cliquez sur un nœud Point de terminaison de service.

2. Modifiez les paramètres dans les grilles de propriété.

Ajout d'une adresse de base

1. Cliquez sur le nœud Hôte.

2. Cliquez sur le bouton Nouveau dans la section Adresses de base.

3. Tapez l'URI de l'adresse de base dans la boîte de dialogue.

4. Cliquez sur OK.

Client

Le nœud Client affiche tous les points de terminaison clients dans le fichier de configuration. Chaque sous-nœud dans l’arbre correspond à un sous-élément de l’élément <client> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Client, vous pouvez afficher ou exécuter des tâches dans la page Résumé du volet Détail.

Création d'une configuration de point de terminaison client

Vous pouvez créer une configuration de point de terminaison client de l'une des manières suivantes :

• Création à l’aide d’un Assistant : cliquez sur le lien Créer un client dans le volet des tâches dans la partie inférieure gauche de la fenêtre, ou dans la page Résumé pour lancer l’Assistant. Vous pouvez également le faire dans le menu Fichier ->Ajouter un nouvel élément. L'Assistant vous invite à désigner l'emplacement de la configuration du service, à partir duquel la configuration cliente est générée. Vous pouvez alors choisir le point de terminaison de service avec lequel établir une connexion.

• Manuellement : cliquez avec le bouton droit sur le nœud Points de terminaison sous Client et sélectionnez Nouveau point de terminaison de client.

Modification d'une configuration de point de terminaison client

1. Cliquez sur un nœud Point de terminaison de client.

2. Modifiez les paramètres dans les grilles de propriété.

Point de terminaison standard

Les points de terminaison standard sont des points de terminaison spécialisés possédant une ou plusieurs parties de l’adresse, contrat et liaison définies sur les valeurs par défaut.

Ces paramètres de configuration sont stockés dans le nœud Point de terminaison standard. Le nœud Point de terminaison standard affiche tous les paramètres de point de terminaison standard dans le fichier de configuration. Chaque sous-nœud dans l’arbre correspond à un sous-élément de l’élément <standardEndpoints> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Point de terminaison standard, vous pouvez afficher ou exécuter des tâches dans la page Résumé des points de terminaison standard du volet Détail.

Création d'une configuration de point de terminaison standard

Vous pouvez créer une configuration de point de terminaison standard de l'une des manières suivantes :

• Cliquez avec le bouton droit sur le nœud Point de terminaison standard et sélectionnez Nouvelle configuration de point de terminaison standard. Sélectionnez ensuite le type de liaison dans la boîte de dialogue et cliquez sur OK.

• Sélectionnez le nœud Point de terminaison standard et cliquez sur Nouvelle configuration de point de terminaison standard dans le volet des tâches dans la partie inférieure gauche de la fenêtre.

La boîte de dialogue Création d’un point de terminaison standard liste tous les types de point de terminaison standard enregistrés.

Affichage et modification d'une configuration de point de terminaison standard

Vous pouvez ouvrir une configuration de point de terminaison standard en vue de l'afficher et de la modifier des façons suivantes :

• Cliquez pour développer le nœud Point de terminaison standard et cliquez sur le sous-nœud de point de terminaison concerné.

• Cliquez sur le nœud Point de terminaison standard et cliquez sur le point de terminaison concerné dans le volet Détails.

Les attributs correspondant au point de terminaison s'affichent dans le volet droit pour modification.

Suppression d'une configuration de point de terminaison standard

Vous pouvez supprimer une configuration de point de terminaison standard de l'une des manières suivantes :

• Cliquez pour développer le nœud Point de terminaison standard et cliquez avec le bouton droit sur le sous-nœud de point de terminaison concerné. Sélectionnez la commande Supprimer la configuration de point de terminaison standard dans le menu contextuel pour supprimer le point de terminaison.

• Cliquez sur le nœud Point de terminaison standard. Dans le volet Tâche, cliquez sur Supprimer la configuration de point de terminaison standard.

Si le point de terminaison standard est en cours d’utilisation, un message d’avertissement apparaît lorsque vous essayez de le supprimer : Le point de terminaison standard est en cours d’utilisation. Si vous le supprimez maintenant, veillez à supprimer toutes ses références dans d’autres parties de la configuration (par exemple, dans le point de terminaison de service ou le point de terminaison de client). Sinon, la configuration ne sera pas valide et ne pourra pas être ouverte la prochaine fois. Voulez-vous vraiment effectuer la suppression ?

Liaison

Les configurations de liaison sont utilisées pour configurer des liaisons sur les points de terminaison. Ces paramètres de configuration sont stockés dans le nœud Liaison. Les points de terminaison référencent les configurations de liaison par nom et plusieurs points de terminaison peuvent référencer une configuration de liaison unique.

Le nœud Liaisons affiche tous les paramètres de liaison dans le fichier de configuration. Chaque sous-nœud dans l’arbre correspond à un sous-élément de l’élément <bindings> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Liaisons, vous pouvez afficher ou exécuter des tâches dans la page Résumé du volet Détail de la liaison.

Création d’une configuration de liaison

Vous pouvez créer une configuration de liaison de l’une des manières suivantes :

• Cliquez avec le bouton droit sur le nœud Liaisons et sélectionnez Nouvelle configuration de liaison. Sélectionnez le type de liaison dans la boîte de dialogue et cliquez sur OK.

• Sélectionnez le nœud Liaisons et cliquez sur Nouvelle configuration de liaison dans le volet des tâches en bas à gauche de la fenêtre.

• Dans la page de service ou de résumé de client, cliquez sur Cliquez ici pour créer dans le champ Configuration de liaison afin de créer une configuration de liaison pour le point de terminaison correspondant.

Ajout d'extensions d'élément de liaison à une liaison personnalisée

1. Sélectionnez la liaison à laquelle vous souhaitez ajouter une extension d'élément.

2. Cliquez sur Add.

3. Dans la liste d'extensions disponibles, sélectionnez l'extension d'élément de liaison que vous souhaitez ajouter. Pour sélectionner plusieurs éléments, appuyez simultanément sur la touche CTRL.

4. Cliquez sur Add.

Ajustement de la position d’extensions dans une liaison personnalisée

Une liaison personnalisée est une collection d’éléments de liaison qui forment une pile. Chaque élément de liaison sur la pile possède ses propres paramètres de configuration. L’ordre des extensions d’élément de liaison dans une liaison personnalisée indique leur position dans la pile. Les éléments en haut de la pile sont appliqués en premier. Pour modifier l'ordre :

1. Sélectionnez le nœud de liaison personnalisé.

2. Sélectionnez un élément d’extension de liaison dans la section Position d’extension de l’élément de liaison.

3. Utilisez le bouton Haut ou Bas sur le côté gauche de la liste pour modifier la position de l’élément sélectionné.

Modification de la configuration d’extensions d’élément de liaison dans une liaison personnalisée

1. Sélectionnez le nœud de liaison dans l’arbre.

2. Sélectionnez la liaison personnalisée qui contient l'élément que vous souhaitez modifier.

3. Sélectionnez l'extension d'élément de liaison que vous souhaitez modifier. Les paramètres de l'élément apparaissent dans le volet droit où ils peuvent être modifiés.

Diagnostics

Le nœud Diagnostics affiche tous les paramètres de diagnostic dans le fichier de configuration. Il vous permet d’activer ou de désactiver des compteurs de performance et WMI (Windows Management Instrumentation), de configurer le traçage WCF et de configurer l’enregistrement des messages WCF. Les paramètres du nœud Diagnostics correspondent à la section <system.diagnostics> et à la section <diagnostics> dans <system.serviceModel> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Diagnostics, vous pouvez afficher ou exécuter des tâches dans la page Résumé du volet Détail.

Configuration des compteurs de performance et de WMI

1. Cliquez sur le nœud Diagnostics.

2. Cliquez sur Basculer les compteurs de performance. Le compteur de performance peut avoir trois états : Off (valeur par défaut), ServiceOnly et All. Il est possible de basculer entre les trois états en cliquant sur le lien.

Configuration d'un fournisseur WMI

1. Cliquez sur le nœud Diagnostics.

2. Pour activer un fournisseur WMI, cliquez sur le lien Activer le fournisseur WMI.

Activation du suivi WCF

Vous pouvez créer un fichier de suivi WCF avec des propriétés standard ou configurer un fichier de suivi personnalisé.

1. Cliquez sur le nœud Diagnostics.

2. Cliquez sur Activer le suivi.

3. Cliquez sur le lien Niveau de suivi pour ajuster le niveau de suivi. Six niveaux de suivi sont disponibles : Fermé, Critique, Erreur, Avertissement, Information et Commentaires. Les options Suivi d’activité et Propager l’activité vous permettent d’utiliser la fonctionnalité de suivi d’activité WCF.

4. Cliquez sur le nom de l'écouteur de suivi pour spécifier le fichier et les options de suivi.

Activation de la journalisation WCF

Vous pouvez créer un fichier de suivi WCF avec des propriétés standard ou configurer un fichier de suivi personnalisé.

1. Cliquez sur le nœud Diagnostics.

2. Cliquez sur Activer la journalisation des messages.

3. Cliquez sur le lien Niveau du journal pour ajuster le niveau du journal. Il existe trois niveaux de journal : Messages malformés, Service et Transport.

4. Cliquez sur le nom de l'écouteur pour spécifier le fichier journal et les options de suivi.

La page Résumé des diagnostics vous permet d’accomplir les tâches les plus courantes pour configurer les diagnostics. Toutefois, si vous souhaitez modifier les paramètres des écouteurs et des sources manuellement, vous devez développer le nœud Diagnostics et modifier les paramètres dans les nœuds Journalisation des messages, Écouteurs et Sources.

Activation de la journalisation des messages ou le suivi personnalisé de WCF

1. Cliquez sur le nœud Diagnostics et développez-le.

2. Cliquez avec le bouton droit sur le nœud Écouteurs et sélectionnez Nouvel écouteur.

3. Tapez le nom de fichier de trace dans le champ InitData. Cliquez sur le bouton « … » pour naviguer jusqu’à un chemin.

4. Si vous cliquez sur la ligne TypeName, un bouton « … » s’affiche. Cliquez sur ce bouton pour ouvrir l’Explorateur de types d’écouteur de suivi, que vous pouvez utiliser pour rechercher des écouteurs de suivi préconfigurés qui sont déjà installés.

5. Notez la section Source. Cliquez sur Ajouter dans cette section pour ouvrir une boîte de dialogue avec un menu déroulant qui liste les sources de suivi disponibles. Sélectionnez une source de suivi et cliquez sur OK.

6. Pour modifier les paramètres de journalisation des messages, cliquez sur le nœud Journalisation des messages. Vous pouvez modifier les paramètres dans la grille des propriétés.

Avancé

Comportements

Le nœud Comportements affiche les comportements définis actuellement dans le fichier de configuration.

Les configurations de comportement sont utilisées pour configurer des comportements de points de terminaison et de services. Ces paramètres de configuration sont stockés dans le nœud Avancé sous Comportements de service et Comportements du point de terminaison. Les comportements de service sont utilisés par les services, alors que les comportements de point de terminaison par les points de terminaison.

Les comportements représentent un ensemble d’éléments d’extension qui forment une pile. L'élément en haut de la pile est appliqué en premier. Chaque élément d’extension peut avoir sa propre configuration.

Création d'une configuration de comportement

Vous pouvez créer une nouvelle configuration de comportement de l'une des manières suivantes :

• Cliquez avec le bouton droit sur l’un des nœuds de comportement et sélectionnez Nouvelle configuration de comportement.

• Sélectionnez l’un des nœuds de comportement et cliquez sur Nouvelle configuration de comportement dans le volet des tâches en bas à gauche de la fenêtre.

Ajout d’extensions d’éléments de comportement à un comportement

1. Sélectionnez l'un des nœuds de comportement.

2. Sélectionnez le comportement que vous souhaitez modifier.

3. Cliquez sur Add.

4. Dans la liste d’extensions disponibles, sélectionnez l’extension d’élément de comportement que vous souhaitez ajouter.

5. Cliquez sur Add.

Ajustement de la position d’extension dans un comportement

Les comportements sont des collections d'élément qui forment une pile. Chaque élément sur la pile possède sa propre configuration. L’ordre des extensions d’éléments de comportement dans un comportement personnalisé indique leur position dans la pile. Les éléments en haut de la pile sont appliqués en premier. Pour modifier l'ordre :

1. Sélectionnez l'un des nœuds de comportement.

2. Sélectionnez le comportement que vous souhaitez modifier.

3. Sélectionnez un élément d’extension de comportement dans la section Position d’extension de l’élément de liaison.

4. Utilisez le bouton Haut ou Bas sur le côté gauche de la liste pour modifier la position de l’élément sélectionné.

Modification la configuration des extensions d’élément de comportement

1. Sélectionnez l’un des nœuds de comportement dans l’arbre.

2. Sélectionnez le comportement qui contient l'élément que vous souhaitez modifier.

3. Sélectionnez l'extension d'élément de comportement que vous souhaitez modifier. Les paramètres de l'élément apparaissent dans le volet droit où ils peuvent être modifiés.

ProtocolMapping

Cette section permet de configurer des types de liaison par défaut pour différents protocoles (tels que HTTP, TCP, MSMQ ou net.pipe) en appliquant un mappage défini entre les schémas d'adresse de protocole et les liaisons possibles. Vous pouvez également ajouter de nouveaux mappages à d'autres protocoles.

Extensions

Les nouvelles extensions de liaison, les extensions d’élément de liaison, les extensions de point de terminaison standard et les extensions de comportement peuvent être enregistrées en vue d’être utilisées dans la configuration WCF. Les extensions sont des paires de nom/type. Le nom définit le nom de l’extension dans la configuration, alors que le type implémente l’extension. Il existe quatre types d’extension :

• Les extensions de liaison définissent un type de liaison entier. Exemple : basicHttpBinding.

• Les extensions d'élément de liaison définissent un élément d'une liaison. Exemple : textMessageEncoding.

• Les extensions de point de terminaison standard définissent un point de terminaison standard entier. Exemple : discoveryEndpoint.

• Les extensions d’élément de comportement définissent un élément d’un comportement. Exemple : clientVia.

Les extensions inscrites dans la configuration peuvent être utilisées comme tout autre composant WCF du même type.

Ajout d'une nouvelle extension

Sélectionnez l’un des nœuds d’extension parmi les nœuds avancés.

1. Cliquez sur Nouveau.

2. Entrez un nom et un type.

3. Cliquez sur OK.

4. L’extension apparaît maintenant dans l’éditeur à l’endroit approprié. Par exemple, si vous ajoutez une extension d’élément de comportement, elle apparaît dans la liste des extensions disponibles.

Environnement d'hébergement

Cette section permet de définir des paramètres d'instanciation pour l'environnement d'hébergement de service.

Création d'un fichier de configuration à l'aide de l'Assistant

Pour créer un fichier de configuration, vous pouvez notamment utiliser l'Assistant Nouvel élément de service. L’Assistant recherche les types de service installés et d’autres éléments compatibles avec WCF sur l’ordinateur, y compris les répertoires virtuels hébergés sur le web et les répertoires COM+, et il les charge pour simplifier la création du fichier de configuration.

Création d'un fichier de configuration

1. Démarrez l’Éditeur de configuration de service en utilisant une fenêtre de commande pour accéder à votre emplacement d’installation WCF, puis tapez SvcConfigEditor.exe.

2. Dans le menu Fichier, sélectionnez Ouvrir et cliquez sur Exécutable, Service COM+ ou Service hébergé sur le web, en fonction du type de fichier de configuration que vous souhaitez créer.

3. Dans la boîte de dialogue Ouvrir, naviguez jusqu’au fichier spécifique pour lequel vous souhaitez créer un fichier de configuration et double-cliquez dessus.

4. Dans le menu Fichier, pointez sur Ajouter un nouvel élément et cliquez sur Service. L'Assistant Nouvel élément de service s'ouvre.

5. Suivez les étapes de création de service dans l'Assistant.

Configuration de COM+

L'Éditeur de configuration de service vous permet de créer un fichier de configuration pour une application COM+ existante ou de modifier une configuration COM+ existante. Le nœud Contrat COM est visible uniquement lorsque la section <comContract> existe dans le fichier de configuration.

Création d'une nouvelle configuration COM+

Avant de créer une configuration COM+, assurez-vous que votre application COM+ est installée dans les services de composants et enregistrée dans le Global Assembly Cache (GAC).

1. Sélectionnez le menu Fichier ->Intégrer ->Application COM+. Cette opération ferme le fichier actuellement ouvert. Si des données ne sont pas enregistrées dans le fichier actif, une boîte de dialogue d'enregistrement apparaît. L’Assistant Intégration COM+ est ensuite lancé.

2. Dans la première page, sélectionnez l'application COM+ de l'arbre. Si vous ne trouvez pas votre application COM+ dans l’arbre, vérifiez qu’il est installé dans les services de composants et enregistré dans le Global Assembly Cache (GAC).

3. Dans la page suivante, sélectionnez les méthodes que vous souhaitez exposer en tant que services WCF. Toutes les méthodes prises en charge dans l'application COM+ sont affichées et sélectionnées par défaut.

4. Choisissez une méthode d'hébergement.

5. Configurez d'autres paramètres conformément aux indications de l'Assistant.

6. L'Éditeur de configuration de service utilise ComSvcConfig.exe en arrière-plan pour générer un fichier de configuration. Une fois terminé, vous pouvez consulter un résumé et quitter l'Assistant. Le fichier de configuration généré est ouvert afin que vous puissiez le modifier directement.

Modification d'une configuration COM+ existante

1. Sélectionnez le menu Fichier ->Ouvrir ->Service COM+.

2. Sélectionnez le service COM+ que vous souhaitez modifier dans la liste.

3. Modifiez les paramètres de configuration dans le nœud Contrats COM.

   Notes

   Vous pouvez également ouvrir et modifier directement un fichier de configuration qui contient des contrats COM+.

Sécurité

Le caractère sécurisé des fichiers de configuration de service générés par l'Éditeur de configuration n'est pas garanti. Consultez la documentation Sécurité pour plus d’informations sur la méthode permettant de sécuriser vos services WCF.

De plus, l'Éditeur de configuration peut être utilisé uniquement pour lire et écrire des éléments de configuration WCF valides. Cet outil ignore les éléments conformes à des schémas, définis par l'utilisateur. Il ne tente pas non plus de supprimer ces éléments du fichier de configuration ou de déterminer leurs effets sur les éléments WCF connus. Il incombe à l'utilisateur de déterminer si ces éléments font peser une menace à l'application ou au système.