Outil Éditeur de configuration (SvcConfigEditor.exe)Configuration Editor Tool (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).The Windows Communication Foundation (WCF) Service Configuration Editor (SvcConfigEditor.exe) allows administrators and developers to create and modify configuration settings for WCF services using a graphical user interface. 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.With this tool, you can manage settings for WCF bindings, behaviors, services, and diagnostics without having to directly edit XML configuration files.

L’Éditeur de configuration de service se trouve dans le dossier C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.Service Configuration Editor can be found in the C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin folder.

Éditeur de configuration WCFThe WCF Configuration Editor

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.Service Configuration Editor comes with a wizard that guides you through all the steps in configuring a WCF service or client. Il est vivement recommandé d'utiliser l'Assistant au lieu d'utiliser directement l'éditeur.You are strongly advised to use the wizard instead of the editor directly.

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.If you already have some configuration files that comply with the standard System.Configuration schema, you can manage specific settings for bindings, behavior, services, and diagnostics with the user interface. 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.The Service Configuration Editor enables you to manage the settings for existing WCF configuration files as well as executable files, COM+ services, and Web-hosted services. 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.When opening a Web-hosted service with Service Configuration Editor, both the service’s own configuration and inherited configurations sections of upper level nodes are shown.

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.Because WCF configuration settings are located in the <system.serviceModel> section of the configuration file, the editor operates exclusively on the content of this element and does not access other elements in the same file. 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+.You can navigate to existing configuration files directly or you can select an assembly that contains a service, virtual directory, or COM+ service. 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.The editor loads the configuration file for that particular service and allows the user to either add new elements or edit existing elements nested in the <system.serviceModel> section of the configuration file.

L'éditeur prend en charge IntelliSense et applique la conformité de schéma.The editor supports IntelliSense and enforces schema compliance. Le résultat est conformer au schéma du fichier de configuration et possède des valeurs de données correctes syntaxiquement.The resulting output is guaranteed to comply with the schema of the configuration file and to have syntactically correct data values. Toutefois, l'éditeur ne garantit pas que le fichier de configuration soit correct sur un plan sémantique.However, the editor does not guarantee that the configuration file is semantically valid. En d'autres termes, l'éditeur ne garantit pas que le fichier de configuration puisse fonctionner avec le service qu'il configure.In other words, the editor does not guarantee that the configuration file can work with the service it configures.

Attention

L'éditeur ne peut pas supprimer un élément de configuration du fichier de configuration une fois que vous avez modifié l'élément.The editor cannot purge a configuration element from the configuration file once you have modified the element. Par exemple, si vous utilisez l'éditeur pour affecter au nom de point de terminaison une chaîne non vide et l'enregistrer, le contenu du fichier de configuration est le suivant, comme illustré dans l'exemple suivant.For example, if you use the editor to set the endpoint name to a non-empty string and save it, the configuration file has the following content, as shown in the following example.

<endpoint binding="basicHttpBinding" name="somename" />

Si vous tentez de supprimer le nom en lui affectant une chaîne vide et que vous enregistrez le fichier, le fichier de configuration contient toujours l'attribut name, comme illustré dans l'exemple suivant.If you attempt to remove the name by setting it to an empty string and save the file, the configuration file still contains the name attribute, as shown in the following example.

<endpoint binding="basicHttpBinding" name="" />

Pour supprimer l'attribut, vous devez modifier manuellement l'élément à l'aide d'un autre éditeur de texte.To purge the attribute, you must manually edit the element using another text editor.

Vous devez être particulièrement prudent avec ce problème lorsque vous utilisez l'élément issueToken du comportement de point de terminaison clientCredential.You should be especially careful with this issue when you use the issueToken element of the clientCredential Endpoint behavior. De façon spécifique, l'attribut address de son sous-élément localIssuer ne doit pas être une chaîne vide.Specifically, the address attribute of its localIssuer sub-element must not be an empty string. Si vous avez modifié l'attribut address à l'aide de l'Éditeur de configuration et que vous souhaitez le supprimer complètement, vous devez pour cela utiliser un autre outil que l'Éditeur.If you have modified the address attribute using the Configuration Editor and want to remove it completely, you should do so using a tool other than the Editor. Sinon, l'attribut contient une chaîne vide et votre application lève une exception.Otherwise, the attribute contains an empty string and your application throws an exception.

Utilisation de l'Éditeur de configurationUsing the Configuration Editor

L'Éditeur de configuration de service se trouve à l'emplacement d'installation du Kit de développement logiciel (SDK) Windows suivant :The Service Configuration Editor can be found at the following Windows SDK installation location:

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

Une fois que vous lancez l’éditeur de Configuration de Service, vous pouvez utiliser la fichier/ouvrir menu pour accéder au service ou d’un assembly que vous souhaitez gérer.After you launch the Service Configuration Editor, you can use the File/Open menu to browse for the service or assembly you want to manage. 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.You can open configuration files directly, browse for WCF /COM+ services, and open configuration files for Web-hosted services.

L'interface utilisateur de l'Éditeur de configuration de service est divisée dans les zones suivantes :The Service Configuration Editor's user interface is divided into the following areas:

  • Volet (arborescence) qui affiche les éléments de configuration sous forme d'arborescence à gauche.Tree View Pane, which displays configuration elements in a tree structure on the left. Vous pouvez exécuter des opérations dans l’arbre en cliquant avec le bouton droit sur les nœuds.You can perform operations in the tree by right-clicking the nodes.

  • 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.Task Pane, which displays common tasks for current elements on the lower-left of the window

  • Volet Détail qui affiche les paramètres détaillés du nœud de configuration sélectionné dans l'arborescence à droite.Detail Pane, which displays detailed settings of the configuration node selected in the Tree View on the right.

Ouverture d'un fichier de configurationOpening a Configuration File

  1. Démarrez l’éditeur de Configuration de Service à l’aide d’une fenêtre de commande et accédez à votre emplacement d’installation de WCF, puis tapez SvcConfigEditor.exe.Start Service Configuration Editor by using a command window to navigate to your WCF installation location, and then type SvcConfigEditor.exe.

  2. À partir de la fichier menu, sélectionnez ouvrir et cliquez sur le type de fichier que vous souhaitez gérer.From the File menu, select Open and click the type of file you want to manage.

  3. Dans le ouvrir boîte de dialogue, accédez au fichier spécifique que vous souhaitez gérer et double-cliquez dessus.In the Open dialog box, navigate to the specific file you want to manage and double-click it.

La visionneuse suit automatiquement le chemin d’accès de fusion de la configuration et crée une vue de la configuration fusionnée.The viewer automatically follows the configuration merge path and creates a view of the merged configuration. 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.For example, the actual configuration of a non-hosted service is a combination of Machine.config and App.config. Any changes are applied to the active file in the 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.If you want to edit a specific file in the configuration merge path, you should open it directly.

Note

L'Éditeur de configuration recharge le fichier de configuration actuellement ouvert lorsque ce dernier a été modifié à l'extérieur de l'Éditeur.Configuration Editor reloads the currently opened configuration file when the latter has been modified outside the Editor. Lorsque cela se produit, toutes les modifications non enregistrées dans l'Éditeur sont perdues.When this happens, all the changes that are not durably saved inside the Editor are lost. Si les rechargements sont fréquents, la cause la plus probable est l'accès constant d'un service au fichier de configuration (par exemple, un logiciel antivirus exécuté en arrière-plan).If reloading happens consistently, the most likely cause is a service that constantly accesses the configuration file, for example, an antivirus software running in the background. Pour y remédier, vérifiez que l'éditeur de configuration est l'unique processus autorisé à accéder au fichier lorsque celui-ci est ouvert.To resolve this, ensure that Configuration Editor is the only process that can access the file when it is opened.

ServicesServices

Le Services nœud affiche tous les services assignés actuellement dans le fichier de configuration.The Services node displays all of the services currently assigned in the configuration file. Chaque nœud secondaire dans l’arborescence correspond à un sous-élément de la <services> élément dans le fichier de configuration.Each sub-node in the tree corresponds to a sub-element of the <services> element in the configuration file.

Lorsque vous cliquez sur le Services nœud, vous pouvez afficher ou exécuter des tâches dans la Page de résumé dans le détail volet.When you click the Services node, you can view or perform tasks on the service Summary Page in the Detail Pane.

Création d'une configuration de serviceCreating a new Service Configuration

Vous pouvez créer une configuration de service de l'une des manières suivantes :You can create a new service configuration in the following ways:

  • À l’aide d’un Assistant : cliquez sur le lien créer un nouveau Service...Using a Wizard: Click the link Create a New Service… dans le volet de tâches ou la Page de résumé pour lancer l’Assistant.on the Task Pane or Summary Page to launch the wizard. Vous pouvez également l’effectuer dans le fichier menu -> ajouter un nouvel élément.You can also do so in the File menu -> Add New Item.

  • Créer manuellement : vous pouvez cliquer sur le Services nœud et choisissez nouveau Service.Create manually: You can right-click the Services node and choose New Service.

Création d'une configuration de point de terminaison de serviceCreating a new Service Endpoint Configuration

Vous pouvez créer une nouvelle configuration de point de terminaison de service de l'une des manières suivantes :You can create a new service endpoint configuration in the following ways:

  • Créer à l’aide d’un Assistant : cliquez sur le lien créer un nouveau point de terminaison de Service...Create using a Wizard: click the link Create a New Service Endpoint… dans le volet de tâches ou la Page de résumé pour lancer l’Assistant.on the Task Pane or Summary Page to launch the wizard. Vous pouvez également l’effectuer dans le fichier menu -> ajouter un nouvel élément.You can also do so in the File menu -> Add New Item.

  • Créer manuellement : une fois que vous avez créé un Service, vous pouvez cliquer sur le points de terminaison nœud et choisissez «nouveau point de terminaison de Service».Create manually: Once you created a Service, you can right-click the Endpoints node and choose "New Service Endpoint".

Modification d'une configuration de serviceEditing a Service Configuration

  1. Cliquez sur un Service nœud.Click a Service node.

  2. Modifiez les paramètres dans les grilles de propriété.Edit the settings in the property grids.

Modification d'une configuration de points de terminaison de serviceEditing a Service Endpoint Configuration

  1. Cliquez sur un point de terminaison de Service nœud.Click a Service Endpoint node.

  2. Modifiez les paramètres dans les grilles de propriété.Edit the settings in the property grids.

Ajout d'une adresse de baseAdding a Base Address

  1. Cliquez sur le hôte nœud.Click the Host node.

  2. Cliquez sur le nouveau...Click the New… bouton dans le les adresses de Base section.button in the Base Addresses section.

  3. Tapez l'URI de l'adresse de base dans la boîte de dialogue.Type in the base address URI in the dialog box.

  4. Cliquez sur OK.Click OK.

Note

Vous ne pouvez pas modifier la valeur de <baseAddressPrefixFilters > à l’intérieur de cet outil.You cannot edit the value of <baseAddressPrefixFilters> inside this tool. Pour ajouter ou modifier cet élément, vous devez utiliser un éditeur de texte ou Visual Studio.To add or modify this element, you should use a text editor or Visual Studio.

ClientClient

Le Client nœud affiche tous les points de terminaison client dans le fichier de configuration.The Client node displays all of the client endpoints in the configuration file. Chaque nœud secondaire dans l’arborescence correspond à un sous-élément de la <client> élément dans le fichier de configuration.Every sub-node in the tree corresponds to a sub-element of the <client> element in the configuration file.

Lorsque vous cliquez sur le Client nœud, vous pouvez afficher ou exécuter des tâches sur le client Page Résumé dans les volet Détail.When you click the Client node, you can view or perform tasks on the client Summary Page in the Detail Pane.

Création d'une configuration de point de terminaison clientCreating a new Client Endpoint Configuration

Vous pouvez créer une configuration de point de terminaison client de l'une des manières suivantes :You can create a new client endpoint configuration in the following ways:

  • Créer par l’Assistant : cliquez sur le lien créer un nouveau Client en cours...Create by Wizard: Click the link Create a New Client… sur le volet sur inférieur gauche de la fenêtre, ou Page Résumé pour lancer l’Assistant.on the Task Pane on the lower-left of the window, or Summary Page to launch the wizard. Vous pouvez également l’effectuer dans le fichier menu -> ajouter un nouvel élément.You can also do so in the File menu -> Add New Item. L'Assistant vous invite à désigner l'emplacement de la configuration du service, à partir duquel la configuration cliente est générée.The wizard prompts you to point to the location of the service configuration, from which the client configuration is generated. Vous pouvez alors choisir le point de terminaison de service avec lequel établir une connexion.You can then choose the service endpoint to connect to.

  • Créer manuellement : avec le bouton droit le points de terminaison nœud sous Client, puis choisissez nouveau point de terminaison Client.Create manually: Right-click the Endpoints node under Client, and choose New Client Endpoint.

Modification d'une configuration de point de terminaison clientEditing a Client Endpoint Configuration

  1. Cliquez sur un point de terminaison Client nœud.Click a Client Endpoint node.

  2. Modifiez les paramètres dans les grilles de propriété.Edit the settings in the property grids.

Point de terminaison standardStandard Endpoint

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.Standard endpoints are specialized endpoints that have one or more aspects of the address, contract and binding set to default values.

Ces paramètres de configuration sont stockés dans le point de terminaison Standard nœud.Such configuration settings are stored in the Standard Endpoint node. Le point de terminaison Standard nœud affiche tous les paramètres de point de terminaison standard dans le fichier de configuration.The Standard Endpoint node displays all of the standard endpoint settings in the configuration file. Chaque nœud secondaire dans l’arborescence correspond à un sous-élément dans le <standardEndpoints> élément dans le fichier de configuration.Every sub-node in the tree corresponds to a sub-element in the <standardEndpoints> element in the configuration file.

Lorsque vous cliquez sur le point de terminaison Standard nœud, vous pouvez afficher ou exécuter des tâches sur le point de terminaison standard Page Résumé dans les volet Détail.When you click the Standard Endpoint node, you can view or perform tasks on the standard endpoint Summary Page in the Detail Pane.

Création d'une configuration de point de terminaison standardCreating a New Standard Endpoint Configuration

Vous pouvez créer une configuration de point de terminaison standard de l'une des manières suivantes :You can create a new standard endpoint configuration in the following ways:

  • Cliquez sur le point de terminaison Standard nœud et sélectionnez nouvelle Configuration de point de terminaison Standard...Right-click the Standard Endpoint node and select New Standard Endpoint Configuration… Sélectionnez le type de liaison dans la boîte de dialogue, cliquez sur OK.Select the binding type in the dialog box and click OK.

  • Sélectionnez le point de terminaison Standard nœud et cliquez sur nouvelle Configuration de point de terminaison Standard...Select the Standard Endpoint node and click New Standard Endpoint Configuration… dans le volet sur bas à gauche de la fenêtre.in the Task Pane on the lower-left of the window.

Le création d’un nouveau point de terminaison Standard boîte de dialogue affiche et répertorie les types de point de terminaison standard Enregistrer.The Creating a New Standard Endpoint dialog box displays and lists all registered standard endpoint types.

Affichage et modification d'une configuration de point de terminaison standardViewing and Editing a Standard Endpoint Configuration

Vous pouvez ouvrir une configuration de point de terminaison standard en vue de l'afficher et de la modifier des façons suivantes :You can open a standard endpoint configuration for viewing and editing in the following ways:

  • Cliquez pour développer le point de terminaison Standard nœud et cliquez sur le sous-nœud de point de terminaison respectif.Click to expand the Standard Endpoint node and click the respective endpoint sub-node.

  • Cliquez sur le point de terminaison Standard nœud et cliquez sur le point de terminaison respectif dans le volet de détails.Click the Standard Endpoint node and click the respective endpoint on the Detail pane.

Les attributs correspondant au point de terminaison s'affichent dans le volet droit pour modification.Attributes for the endpoint are shown in the right pane for editing.

Suppression d'une configuration de point de terminaison standardDeleting a Standard Endpoint Configuration

Vous pouvez supprimer une configuration de point de terminaison standard de l'une des manières suivantes :You can delete a standard endpoint configuration in the following ways:

  • Cliquez pour développer le point de terminaison Standard nœud et avec le bouton droit le sous-nœud de point de terminaison respectif.Click to expand the Standard Endpoint node and right-click the respective endpoint sub-node. Utilisez la commande de contexte supprimer la Configuration de point de terminaison Standard pour supprimer le point de terminaison.Use the context command Delete Standard Endpoint Configuration to delete the endpoint.

  • Cliquez sur le point de terminaison Standard nœud.Click the Standard Endpoint node. Dans le tâche volet, cliquez sur supprimer la Configuration de point de terminaison Standard.In the Task pane, click Delete Standard Endpoint Configuration.

Si le point de terminaison standard est en cours d'utilisation, le message d'avertissement suivant 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. Êtes-vous sûr de que vouloir supprimer le point de terminaison standard ? »If the standard endpoint is in used, a warning message is displayed when you attempt to delete it: The standard endpoint is in use. If you delete it now, please be sure to delete all of its references in other parts of the configuration (for example, in the service endpoint or client endpoint). Otherwise, the configuration will be invalid and cannot be opened next time. Are you sure you want to delete the standard endpoint?"

LiaisonBinding

Les configurations de liaison sont utilisées pour configurer des liaisons sur les points de terminaison.Binding configurations are used to configure bindings on endpoints. Ces paramètres de configuration sont stockés dans le liaison nœud.Such configuration settings are stored in the Binding node. 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.Endpoints reference binding configurations by name and multiple endpoints can reference a single binding configuration.

Le liaisons nœud affiche tous les paramètres de liaison dans le fichier de configuration.The Bindings node displays all of the binding settings in the configuration file. Chaque nœud secondaire dans l’arborescence correspond à un sous-élément dans le <bindings> élément dans le fichier de configuration.Every sub-node in the tree corresponds to a sub-element in the <bindings> element in the configuration file.

Lorsque vous cliquez sur le liaisons nœud, vous pouvez afficher ou exécuter des tâches sur la liaison Page Résumé dans les volet Détail.When you click the Bindings node, you can view or perform tasks on the binding Summary Page in the Detail Pane.

Création d’une configuration de liaisonCreating a New Binding Configuration

Vous pouvez créer une configuration de liaison de l’une des manières suivantes :You can create a new binding configuration in the following ways.

  • Cliquez sur le liaisons nœud et sélectionnez nouvelle Configuration de liaison...Right-click the Bindings node and select New Binding Configuration Sélectionnez le type de liaison dans la boîte de dialogue, cliquez sur OK.Select the binding type in the dialog box and click OK.

  • Sélectionnez le liaisons nœud et cliquez sur nouvelle Configuration de liaison...Select the Bindings node and click New Binding Configuration dans le volet sur bas à gauche de la fenêtre.in the Task Pane on the lower-left of the window.

  • Dans la page de résumé cliente ou de service, cliquez sur cliquez ici pour créer dans les Configuration de liaison champ pour créer une configuration de liaison pour le point de terminaison correspondant.In the service or client summary page, click Click to Create in the Binding Configuration field to create a binding configuration for the corresponding endpoint.

Ajout d’extensions d’élément de liaison à une liaison personnaliséeAdding Binding Element Extensions to a Custom Binding

  1. Sélectionnez la liaison à laquelle vous souhaitez ajouter une extension d’élément.Select the binding you want to add an extension element to.

  2. Cliquez sur Ajouter.Click Add.

  3. Dans la liste d’extensions disponibles, sélectionnez l’extension d’élément de liaison que vous souhaitez ajouter.From the list of available extensions, select the binding element extension you want to add. Pour sélectionner plusieurs éléments, appuyez simultanément sur la touche CTRL.To select multiple items, press the CTRL key simultaneously.

  4. Cliquez sur Ajouter.Click Add.

Ajustement de la position d’extensions dans une liaison personnaliséeAdjusting the Extension Position in a Custom Binding

Une liaison personnalisée est une collection d'éléments de liaison qui forment une pile.A custom binding is a collection of binding elements that form a stack. Chaque élément de liaison sur la pile possède ses propres paramètres de configuration.Each binding element on the stack has its own configuration settings. L'ordre des extensions d'élément de liaison dans une liaison personnalisée indique leur position dans la pile.The order of the binding element extensions in a custom binding indicates their positions in the stack. Les éléments en haut de la pile sont appliqués en premier.Elements at the top of the stack are applied first. Pour modifier l'ordre :To change the ordering:

  1. Sélectionnez le nœud de liaison personnalisé.Select the custom binding node.

  2. Sélectionnez un élément d’extension de liaison dans le Position Extension d’élément de liaison section.Select one binding extension element in the Binding Element Extension Position section.

  3. Utilisez le des ou vers le bas bouton sur le côté gauche de la liste pour modifier la position de l’élément sélectionné.Use the Up or Down button on the left side of the list to change the position of the selected element.

Modification de la configuration d’extensions d’élément de liaison dans une liaison personnaliséeEditing the Configuration of Binding Element Extensions in a Custom Binding

  1. Sélectionnez le nœud de liaison dans l’arbre.Select the binding node in the tree.

  2. Sélectionnez la liaison personnalisée qui contient l'élément que vous souhaitez modifier.Select the custom binding that contains the element you want to edit.

  3. Sélectionnez l'extension d'élément de liaison que vous souhaitez modifier.Select the binding element extension you want to edit. Les paramètres de l'élément apparaissent dans le volet droit où ils peuvent être modifiés.The settings of the element appear in the right pane, where they can be edited.

DiagnosticsDiagnostics

Le Diagnostics nœud affiche tous les paramètres de diagnostic dans le fichier de configuration.The Diagnostics node displays all of the diagnostic settings in the configuration file. Il permet d’activer ou désactiver les compteurs de performance, activer ou désactiver Windows Management Instrumentation (WMI), configurez le suivi WCF et configurer la journalisation de message WCF.It enables you to turn performance counters on or off, enable or disable Windows Management Instrumentation (WMI), configure WCF tracing, and configure WCF message logging. Les paramètres dans le Diagnostics nœud correspond à la <system.diagnostics> section, et <diagnostics> section <system.serviceModel> dans le fichier de configuration.The settings in the Diagnostics node correspond to the <system.diagnostics> section, and <diagnostics> section in <system.serviceModel> in the configuration file.

Lorsque vous cliquez sur le Diagnostics nœud, vous pouvez afficher ou effectuer des tâches sur les tests de diagnostic Page Résumé dans les volet Détail.When you click the Diagnostics node, you can view or perform tasks on the diagnostics Summary Page in the Detail Pane.

Configuration des compteurs de performance et de WMIConfiguring performance counters and WMI

  1. Cliquez sur le Diagnostics nœud.Click the Diagnostics node.

  2. Cliquez sur activer/désactiver les compteurs de Performance.Click Toggle Performance Counters. Le compteur de performance peut avoir trois états : Off (valeur par défaut), ServiceOnly et All.The performance counter has three states: Off (default), ServiceOnly, and All. Il est possible de basculer entre les trois états en cliquant sur le lien.Clicking the link toggles the setting among these three states.

Configuration d'un fournisseur WMIConfiguring WMI Provider

  1. Cliquez sur le Diagnostics nœud.Click the Diagnostics node.

  2. Pour activer le fournisseur WMI, cliquez sur le activer le fournisseur WMI lien.To enable WMI provider, click the Enable WMI Provider link.

Activation du suivi WCFEnabling WCF Tracing

Vous pouvez créer un fichier de suivi WCF avec des propriétés standard ou configurer un fichier de suivi personnalisé.You can create a WCF trace file with standard properties or set up a custom trace file.

  1. Cliquez sur le Diagnostics nœud.Click the Diagnostics node.

  2. Cliquez sur activer le traçage.Click Enable Tracing.

  3. Cliquez sur le au niveau de Trace lien pour ajuster le niveau de trace.Click the Trace Level link to adjust the trace level. Six niveaux de suivi sont disponibles : Fermé, Critique, Erreur, Avertissement, Information et Commentaires.There are six trace levels: Off, Critical, Error, Warning, Information, and Verbose. Le le suivi des activités et propager l’activité option vous permet d’utiliser la fonctionnalité de suivi d’activité WCF activer.The Activity Tracing and Propagate Activity option enable you to use the WCF activity tracing feature.

  4. Cliquez sur le nom de l'écouteur de suivi pour spécifier le fichier et les options de suivi.Click the trace listener name to specify the trace file and options.

Activation de la journalisation WCFEnabling WCF Logging

Vous pouvez créer un fichier de suivi WCF avec des propriétés standard ou configurer un fichier de suivi personnalisé.You can create a WCF trace file with standard properties or set up a custom trace file.

  1. Cliquez sur le Diagnostics nœud.Click the Diagnostics node.

  2. Cliquez sur activer la journalisation des messages.Click Enable Message Logging.

  3. Cliquez sur le au niveau du journal lien pour ajuster le niveau de journal.Click the Log Level link to adjust the log level. Il existe trois niveaux de journal : Messages malformés, Service et Transport.There are three log levels: Malformed, Service, and Transport.

  4. Cliquez sur le nom de l'écouteur pour spécifier le fichier journal et les options de suivi.Click the listener name to specify the log file and options.

Note

Si vous souhaitez que les journaux de suivi et de message pour être vidé automatiquement lors de la fermeture de votre application, activez la Effacement automatique option.If you want the trace and message logs to be flushed automatically when your application is closed, enable the Auto Flush option.

Le Diagnostics Page Résumé vous permet d’accomplir les tâches les plus courantes de la configuration de diagnostics.The Diagnostics Summary Page enables you to accomplish the most common tasks in configuring diagnostics. Toutefois, si vous souhaitez modifier les paramètres des écouteurs et des Sources manuellement, vous devez développer la Diagnostics nœud et modifier les paramètres dans Message Logging, écouteurs et Sources nœud.However, if you want to manually edit the Listeners and Sources settings, you must expand the Diagnostics node and edit settings in Message Logging, Listeners and Sources node.

Activation de la journalisation des messages ou le suivi personnalisé de WCFEnabling WCF Custom Tracing or Message Logging

  1. Cliquez sur le Diagnostics nœud, puis développez-le.Click the Diagnostics node, and expand it.

  2. Cliquez sur le écouteurs nœud et sélectionnez nouvel écouteur.Right-click the Listeners node and select New Listener.

  3. Tapez le nom de fichier de trace dans le InitData champ.Type in the trace file name in the InitData field. Vous pouvez cliquer sur le bouton «... » pour accéder à un chemin d’accès.You can click the "…" button to browse to a path.

  4. En cliquant sur le TypeName ligne affiche un bouton «... ».Clicking the TypeName line displays a "…" button. Cliquez sur ce bouton pour ouvrir la Explorateur de types d’écouteur de Trace, que vous pouvez utiliser pour rechercher des écouteurs de suivi préconfigurés qui sont déjà installés.Click this button to open the Trace Listener Type Browser, which you can use to find pre-configured trace listeners that are already installed.

  5. Remarque la Source section.Note the Source section. Cliquez sur ajouter dans cette section pour ouvrir une boîte de dialogue avec un menu déroulant, qui répertorie les sources de suivi disponibles.Click Add in this section to open a dialog box with a drop-down menu, which lists available tracing sources. Sélectionnez une source de suivi, cliquez sur OK.Select a tracing source and click OK.

  6. Pour modifier les paramètres de journalisation des messages, cliquez sur le Message Logging nœud.To edit Message Logging settings, click the Message Logging node. Vous pouvez modifier les paramètres dans la grille des propriétés.You can edit the settings in the property grid.

AvancéAdvanced

comportementsBehaviors

Le comportements nœud affiche les comportements qui sont actuellement définies dans le fichier de configuration.The Behaviors node displays the behaviors that are currently defined in the configuration file.

Les configurations de comportement sont utilisées pour configurer des comportements de points de terminaison et de services.Behavior configurations are used to configure behaviors of endpoints and services. Ces paramètres de configuration sont stockés dans le avancé nœud sous comportements de Service et les comportements de point de terminaison.Such configuration settings are stored in the Advanced node under Service Behaviors and Endpoint Behaviors. Les comportements de service sont utilisés par les services, alors que les comportements de point de terminaison par les points de terminaison.Service behaviors are used by services; whereas endpoint behaviors by endpoints.

Les comportements représentent un ensemble d'éléments d'extension qui forment une pile.Behaviors are a collection of extension elements that for a stack. L'élément en haut de la pile est appliqué en premier.The element at the top of the stack is applied first. Chaque élément d'extension peut avoir sa propre configuration.Each extension element can have its own configuration.

Création d'une configuration de comportementCreating a new Behavior Configuration

Vous pouvez créer une nouvelle configuration de comportement de l'une des manières suivantes :You can create a new behavior configuration in two ways.

  • Cliquez sur un des nœuds de comportement et sélectionnez «nouvelle Configuration de comportementRight-click one of the behavior nodes and select "New Behavior Configuration…

  • Sélectionnez un des nœuds de comportement et cliquez sur le nouvelle Configuration de comportement...Select one of the behavior nodes and click the New Behavior Configuration dans le volet sur bas à gauche de la fenêtre.in the Task Pane on the lower-left of the window.

Ajout d’extensions d’éléments de comportement à un comportementAdding Behavior Element Extensions to a Behavior
  1. Sélectionnez l'un des nœuds de comportement.Select one of the behavior nodes.

  2. Sélectionnez le comportement que vous souhaitez modifier.Select the behavior you want edit.

  3. Cliquez sur Ajouter.Click Add.

  4. Dans la liste d’extensions disponibles, sélectionnez l’extension d’élément de comportement que vous souhaitez ajouter.From the list of available extensions, select the behavior element extension you want to add.

  5. Cliquez sur Ajouter.Click Add.

Ajustement de la position d’extension dans un comportementAdjusting the Extension Position in a Behavior

Les comportements sont des collections d'élément qui forment une pile.Behaviors are collections of elements that form a stack. Chaque élément sur la pile possède sa propre configuration.Each element on the stack has its own configuration. L'ordre des extensions d'éléments de comportement dans un comportement personnalisé indique leur position dans la pile.The order of the behavior element extensions in a behavior indicates their positions in the stack. Les éléments en haut de la pile sont appliqués en premier.Elements at the top of the stack are applied first. Pour modifier l'ordre :To change the ordering:

  1. Sélectionnez l'un des nœuds de comportement.Select one of the behavior nodes.

  2. Sélectionnez le comportement que vous souhaitez modifier.Select the behavior you want edit.

  3. Sélectionnez un élément d’extension de comportement dans les Position d’Extension de comportement élément section.Select a behavior extension element in the Behavior Element Extension Position section.

  4. Utilisez le des ou vers le bas bouton sur le côté gauche de la liste pour modifier la position de l’élément sélectionné.Use the Up or Down button on the left side of the list to change the position of the selected element.

Modification la configuration des extensions d’élément de comportementEditing the Configuration of Behavior Element Extensions
  1. Sélectionnez l'un des nœuds de comportement dans l'arbre.Select one of the behavior nodes in the tree.

  2. Sélectionnez le comportement qui contient l'élément que vous souhaitez modifier.Select the behavior that contains the element you want to edit.

  3. Sélectionnez l'extension d'élément de comportement que vous souhaitez modifier.Select the behavior element extension you want to edit. Les paramètres de l'élément apparaissent dans le volet droit où ils peuvent être modifiés.The settings of the element appear in the right pane where they can be edited.

ProtocolMappingProtocolMapping

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.This section allows you to set default binding types for different protocols such as http, tcp, MSMQ or net.pipe through defined mapping between protocol address schemes and the possible bindings. Vous pouvez également ajouter de nouveaux mappages à d'autres protocoles.You can also add new mappings to other protocols.

ExtensionsExtensions

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 inscrits pour une utilisation dans la configuration WCF.New binding extensions, binding element extensions, standard endpoint extensions and behavior extensions can be registered for use in WCF configuration. Les extensions sont des paires de nom/type.Extensions are name/type pairs. Le nom définit le nom de l'extension dans la configuration, alors que le type implémente l'extension.The name defines the name of the extension in configuration, whereas the type implements the extension. Il existe quatre types d’extension :There are four types of extensions:

  • Les extensions de liaison définissent un type de liaison entier.Binding extensions define an entire binding type. Par exemple : basicHttpBindingExample: basicHttpBinding.

  • Les extensions d’élément de liaison définissent un élément d’une liaison.Binding element extensions define an element of a binding. Par exemple : textMessageEncodingExample: textMessageEncoding.

  • Les extensions de point de terminaison standard définissent un point de terminaison standard entier.Standard endpoint extensions define an entire standard endpoint. Par exemple : discoveryEndpointExample: discoveryEndpoint.

  • Les extensions d'élément de comportement définissent un élément d'un comportement.Behavior element extensions define an element of a behavior. Par exemple : clientViaExample: clientVia.

Les extensions inscrites dans la configuration peuvent être utilisées comme tout autre composant WCF du même type.Extensions that have been registered in configuration can be used like any other WCF component of the same type.

Ajout d’une nouvelle extensionAdding a new extension

Sélectionnez l’un des nœuds d’extension parmi les nœuds avancés.Select one of the extension nodes in the advanced nodes:

  1. Cliquez sur Nouveau.Click New.

  2. Entrez un nom et un type.Enter a name and type.

  3. Cliquez sur OK.Click OK.

  4. L’extension apparaît maintenant dans l’éditeur à l’endroit approprié.The extension now appears in the appropriate place in the Editor. Par exemple, si vous ajoutez une extension d’élément de comportement, elle apparaît dans la liste des extensions disponibles.For example, if you add a behavior element extension, it appears in the list of available extensions.

Environnement d'hébergementHosting Environment

Cette section permet de définir des paramètres d'instanciation pour l'environnement d'hébergement de service.This section allows you to define instantiation settings for the service hosting environment.

Création d'un fichier de configuration à l'aide de l'AssistantCreating a Configuration File Using the Wizard

Pour créer un fichier de configuration, vous pouvez notamment utiliser l'Assistant Nouvel élément de service.One way to create a new configuration file is to use the New Service Element Wizard. L’Assistant recherche les types de service installé et d’autres éléments compatibles avec WCF sur l’ordinateur, y compris COM + et hébergé sur le Web, les répertoires virtuels et les charge pour simplifier la création du fichier de configuration.The wizard finds the installed service types and other elements compatible with WCF on the computer, including COM+ and Web-hosted virtual directories, and loads them to make creating the configuration much more streamlined.

Création d'un fichier de configurationCreating a Configuration File

  1. Démarrez l’éditeur de Configuration de Service à l’aide d’une fenêtre de commande et accédez à votre emplacement d’installation de WCF, puis tapez SvcConfigEditor.exe.Start Service Configuration Editor by using a command window to navigate to your WCF installation location, and then type SvcConfigEditor.exe.

  2. À partir de la fichier menu, sélectionnez ouvrir et cliquez sur exécutable, Service COM +, ou WebHosted Service, selon le type de fichier de configuration que vous souhaitez créer.From the File menu, select Open and click Executable, COM+ Service, or WebHosted Service, depending on the type of configuration file you want to create.

  3. Dans le ouvrir boîte de dialogue, accédez au fichier spécifique que vous souhaitez créer un fichier de configuration et double-cliquez dessus.In the Open dialog box, navigate to the specific file you want to create a configuration file for and double-click it.

  4. Dans le fichier menu, pointez sur ajouter un nouvel élément et cliquez sur Service.In the File menu, point to Add New Item and click Service. L'Assistant Nouvel élément de service s'ouvre.The New Service Element Wizard opens.

  5. Suivez les étapes de création de service dans l'Assistant.Follow the steps in the wizard to create the new service.

Note

Si vous souhaitez utiliser NetPeerTcpBinding inclus dans le fichier de configuration (généré par l'Assistant), vous devez ajouter manuellement un élément de configuration de liaison et modifier l'attribut mode de son élément security en spécifiant "Aucun."If you want to use the NetPeerTcpBinding from the configuration file generated by the Wizard, you have to manually add a binding configuration element and modify the mode attribute of its security element to "None".

Configuration de COM+Configuring 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.The Service Configuration Editor enables you to create a new configuration file for an existing COM+ application, or edit an existing COM+ configuration. Le contrat COM nœud est visible uniquement lorsque le <comContract> section existe dans le fichier de configuration.The COM Contract node is only visible when the <comContract> section exists in the configuration file.

Création d'une nouvelle configuration COM+Creating a New COM+ Configuration

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).Before creating a new COM+ configuration, make sure that your COM+ application is installed in Component Services, and registered in the Global Assembly Cache (GAC).

  1. Sélectionnez fichier menu -> intégrer -> l’Application COM +.Select File menu -> Integrate -> COM+ Application. Cette opération ferme le fichier actuellement ouvert.This operation closes the current opened file. Si des données ne sont pas enregistrées dans le fichier actif, une boîte de dialogue d'enregistrement apparaît.If there is unsaved data in the current file, a Save dialog appears. Le Assistant intégration COM + est ensuite lancée.The COM+ Integration Wizard is then launched.

  2. Dans la première page, sélectionnez l’application COM+ de l’arbre.In the first page, select the COM+ application from the tree. 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).If you cannot find your COM+ application in the tree, verify that it is installed in the Component Services and registered in the Global Assembly Cache (GAC).

  3. Dans la page suivante, sélectionnez les méthodes que vous souhaitez exposer en tant que services WCF.In the next page, select which method(s) you want to expose as WCF services. Toutes les méthodes prises en charge dans l'application COM+ sont affichées et sélectionnées par défaut.All the supported methods in the COM+ application are displayed and selected by default.

  4. Choisissez une méthode d'hébergement.Choose a hosting method.

  5. Configurez d'autres paramètres conformément aux indications de l'Assistant.Configure other settings according to the guides in the wizard.

  6. L'Éditeur de configuration de service utilise ComSvcConfig.exe en arrière-plan pour générer un fichier de configuration.Service Configuration Editor utilizes ComSvcConfig.exe in the background to generate configuration file. Une fois terminé, vous pouvez consulter un résumé et quitter l'Assistant.After this is completed, you can view a summary and exit the wizard. Le fichier de configuration généré est ouvert afin que vous puissiez le modifier directement.The generated configuration file is opened so that you can edit it directly.

Modification d'une configuration COM+ existanteEditing an Existing COM+ Configuration

  1. Sélectionnez fichier menu -> ouvrir -> Service COM +...Select File menu -> Open -> COM+ Service

  2. Sélectionnez le service COM+ que vous souhaitez modifier dans la liste.Select the COM+ Service you want to edit from the list.

  3. Modifier les paramètres de configuration dans le contrats COM nœud.Edit configuration settings in the COM Contracts node.

    Note

    Vous pouvez également ouvrir et modifier directement un fichier de configuration qui contient des contrats COM+.You can also directly open and edit a configuration file that contains COM contracts.

SécuritéSecurity

Le caractère sécurisé des fichiers de configuration de service générés par l'Éditeur de configuration n'est pas garanti.A service configuration file generated by the Configuration Editor is not guaranteed to be secure. Reportez-vous à la sécurité documentation pour savoir comment sécuriser vos services WCF.Please refer to the Security documentation to find out how to secure your WCF services.

De plus, l'Éditeur de configuration peut être utilisé uniquement pour lire et écrire des éléments de configuration WCF valides.In addition, the Configuration Editor can only be used to read and write valid WCF configuration elements. Cet outil ignore les éléments conformes à des schémas, définis par l'utilisateur.The tool ignores schema-compliant, user-defined elements. 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.It also does not attempt remove these elements from the configuration file or determine their effects on the known WCF elements. Il incombe à l'utilisateur de déterminer si ces éléments font peser une menace à l'application ou au système.It is the user’s responsibility to determine whether these elements pose a threat to the application or the system.