Outil d'inscription ServiceModel (ServiceModelReg.exe)ServiceModel Registration Tool (ServiceModelReg.exe)

Cet outil en ligne de commande permet de gérer l'inscription des composants WCF et WF sur un ordinateur unique.This command-line tool provides the ability to manage the registration of WCF and WF components on a single machine. Dans des circonstances normales vous n'avez pas à utiliser cet outil, car les composants WCF et WF sont configurés lors de l'installation.Under normal circumstances you should not need to use this tool as WCF and WF components are configured when installed. Mais si vous rencontrez des problèmes avec l'activation de service, vous pouvez essayer d'inscrire les composants à l'aide de cet outil.But if you are experiencing problems with service activation, you can try to register the components using this tool.

SyntaxeSyntax

ServiceModelReg.exe[(-ia|-ua|-r)|((-i|-u) -c:<command>)] [-v|-q] [-nologo] [-?]  

NotesRemarks

Cet outil se trouve à l'emplacement suivant :The tool can be found in the following location:

%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\

Note

Lorsque l’outil d’inscription ServiceModel est exécuté Windows VistaWindows Vista, le des fonctionnalités Windows boîte de dialogue peut ne pas refléter à qui le Activation HTTP de Windows Communication Foundation option sous Microsoft .NET Framework 3.0 est activée.When the ServiceModel Registration Tool is run on Windows VistaWindows Vista, the Windows Features dialog may not reflect that the Windows Communication Foundation HTTP Activation option under Microsoft .NET Framework 3.0 is turned on. Le des fonctionnalités Windows boîte de dialogue est accessible en cliquant sur Démarrer, puis cliquez sur exécuter , puis en tapant OptionalFeatures.The Windows Features dialog can be accessed by clicking Start, then click Run and then typing OptionalFeatures.

Les tableaux suivants décrivent les options qui peuvent être utilisées avec ServiceModelReg.exe.The following tables describe the options that can be used with ServiceModelReg.exe.

OptionOption DescriptionDescription
-ia Installe les composants WCF et WF.Installs all WCF and WF components.
-ua Désinstalle les composants WCF et WF.Uninstalls all WCF and WF components.
-r Répare les composants WCF et WF.Repairs all WCF and WF components.
-i Installe les composants WCF et WF spécifiés avec –c.Installs WCF and WF components specified with –c.
-u Désinstalle les composants WCF et WF spécifiés avec –c.Uninstalls WCF and WF components specified with –c.
-c Installe ou désinstalle un composant :Installs or uninstalls a component:

-httpnamespace – réservation de Namespace HTTP- httpnamespace – HTTP Namespace Reservation
port - tcpportsharing – TCP service de partage- tcpportsharing – TCP port sharing service
service d’activation - tcpactivation – TCP (non pris en charge sur .NET 4 Client Profile)- tcpactivation – TCP activation service (unsupported on .NET 4 Client Profile)
service - namedpipeactivation – l’activation de canal nommé (non pris en charge sur .NET 4 Client Profile- namedpipeactivation – Named pipe activation service (unsupported on .NET 4 Client Profile
service d’activation - msmqactivation – MSMQ (non pris en charge sur .NET 4 Client Profile- msmqactivation – MSMQ activation service (unsupported on .NET 4 Client Profile
manifestes de suivi des événements - etw – ETW (Windows Vista ou version ultérieure)- etw – ETW event tracing manifests (Windows Vista or later)
-q Mode silencieux (enregistrement des erreurs d'affichage uniquement)Quiet mode (only display error logging)
-v Mode documenté.Verbose mode.
-nologo Supprime le message de copyright et de bannière.Suppresses the copyright and banner message.
-? Affiche le texte de l'aide.Displays help text

Résolution de l'erreur FileLoadExceptionFixing the FileLoadException Error

Si vous avez installé des versions antérieures de WCF sur votre ordinateur, vous risquez d’obtenir un FileLoadFoundException erreur lorsque vous exécutez l’outil ServiceModelReg pour enregistrer une nouvelle installation.If you installed previous versions of WCF on your machine, you may get a FileLoadFoundException error when you run the ServiceModelReg tool to register a new installation. Cela peut se produire même si vous avez supprimé manuellement les fichiers de la précédente installation, mais que vous avez conservé les paramètres machine.config.This can happen even if you have manually removed files from the previous install, but left the machine.config settings intact.

Le message d'erreur est semblable au message suivant.The error message is similar to the following.

Error: System.IO.FileLoadException: Could not load file or assembly 'System.ServiceModel, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)  
File name: 'System.ServiceModel, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089'  

Ce message d'erreur indique que l'assembly de la version 2.0.0.0 de System.ServiceModel a été installé par une version antérieure de CTP (Customer Technology Preview).You should note from the error message that the System.ServiceModel Version 2.0.0.0 assembly was installed by an early Customer Technology Preview (CTP) release. La version actuelle de l’assembly System.ServiceModel est la version 3.0.0.0.The current version of the System.ServiceModel assembly released is 3.0.0.0 instead. Par conséquent, vous rencontrerez ce problème lorsque vous souhaitez installer la version officielle de WCF sur un ordinateur sur lequel une version CTP anticipée de WCF a été installée, mais pas complètement désinstallée.Therefore, this issue is encountered when you want to install the official WCF release on a machine where an early CTP release of WCF was installed, but not completely uninstalled.

ServiceModelReg.exe ne peut pas nettoyer les entrées de versions antérieures ; il ne peut pas non plus enregistrer les entrées de la nouvelle version.ServiceModelReg.exe cannot clean up prior version entries, nor can it register the new version's entries. La seule solution consiste à modifier manuellement le fichier machine.config. Vous trouverez ce fichier à l'emplacement suivant :The only workaround is to manually edit machine.config. You can locate this file at the following location.

%windir%\Microsoft.NET\Framework\v2.0.50727\config\machine.config   

Si vous exécutez WCF sur un ordinateur 64 bits, vous devez également modifier le même fichier à cet emplacement.If you are running WCF on a 64-bit machine, you should also edit the same file at this location.

%windir%\Microsoft.NET\Framework64\v2.0.50727\config\machine.config   

Localiser des nœuds XML dans ce fichier qui font référence à « System.ServiceModel, Version = 2.0.0.0 », supprimez les et les nœuds enfants.Locate any XML nodes in this file that refer to "System.ServiceModel, Version=2.0.0.0", delete them and any child nodes. Enregistrez le fichier et réexécutez ServiceModelReg.exe afin de résoudre ce problème.Save the file and re-run ServiceModelReg.exe resolves this problem.

ExemplesExamples

Les exemples suivants indiquent comment utiliser les options les plus courantes de l'outil ServiceModelReg.exe.The following examples show how to use the most common options of the ServiceModelReg.exe tool.

ServiceModelReg.exe -ia  
  Installs all components  
ServiceModelReg.exe -i -c:httpnamespace -c:etw  
  Installs HTTP namespace reservation and ETW manifests  
ServiceModelReg.exe -u -c:etw  
  Uninstalls ETW manifests  
ServiceModelReg.exe -r  
  Repairs an extended install