Nástroj pro registraci modelu služby (ServiceModelReg.exe)

Tento nástroj příkazového řádku umožňuje spravovat registraci komponent WCF a WF na jednom počítači. Za normálních okolností byste neměli tento nástroj používat jako komponenty WCF a WF jsou při instalaci nakonfigurované. Pokud ale máte problémy s aktivací služby, můžete se pokusit zaregistrovat komponenty pomocí tohoto nástroje.

Syntaxe

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

Poznámky

Nástroj najdete v následujícím umístění:

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

Poznámka:

Pokud je nástroj ServiceModel Registration Tool spuštěn v systému Windows Vista, dialogové okno Funkce systému Windows nemusí odrážet, že je zapnuta možnost aktivace HTTP technologie Windows Communication Foundation v rozhraní Microsoft .NET Framework 3.0 . K dialogovému okně Funkce systému Windows lze získat přístup kliknutím na tlačítko Start a následným zadáním nepovinných funkcí.

Následující tabulky popisují možnosti, které lze použít s ServiceModelReg.exe.

Možnost	Description
-ia	Nainstaluje všechny komponenty WCF a WF.
-ua	Odinstaluje všechny komponenty WCF a WF.
-r	Opraví všechny komponenty WCF a WF.
-i	Nainstaluje komponenty WCF a WF zadané pomocí -c.
-u	Odinstaluje komponenty WCF a WF zadané pomocí -c.
-c	Nainstaluje nebo odinstaluje komponentu: – httpnamespace – rezervace oboru názvů HTTP – tcpportsharing – služba sdílení portů TCP – tcpactivation – aktivační služba TCP (nepodporovaná v profilu klienta .NET 4) - namedpipeactivation – služba aktivace pojmenovaného kanálu (nepodporovaná v profilu klienta .NET 4 – msmqactivation – aktivační služba MSMQ (nepodporovaná v profilu klienta .NET 4) - etw – manifesty trasování událostí trasování událostí pro Windows (Windows Vista nebo novější)
-q	Tichý režim (pouze protokolování chyb zobrazení)
-v	Podrobný režim.
-nologo	Potlačí autorská práva a bannerovou zprávu.
-?	Zobrazí text nápovědy.

Oprava chyby FileLoadException

Pokud jste na svém počítači nainstalovali předchozí verze WCF, může se při FileLoadFoundException spuštění nástroje ServiceModelReg zobrazit chyba pro registraci nové instalace. K tomu může dojít i v případě, že jste ručně odebrali soubory z předchozí instalace, ale nechali machine.config nastavení nedotčená.

Chybová zpráva je podobná následující.

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'

Měli byste si všimnout z chybové zprávy, že sestavení System.ServiceModel verze 2.0.0.0 bylo nainstalováno v rané verzi CTP (Customer Technology Preview). Aktuální verze sestavení System.ServiceModel vydaná je místo toho 3.0.0.0. Proto k tomuto problému dochází, když chcete nainstalovat oficiální verzi WCF na počítač, kde byla nainstalována časná verze CTP WCF, ale není úplně odinstalována.

ServiceModelReg.exe nemůže vyčistit předchozí položky verze ani registrovat položky nové verze. Jediným alternativním řešením je ruční úprava machine.config. Tento soubor můžete najít v následujícím umístění.

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

Pokud používáte WCF na 64bitovém počítači, měli byste také upravit stejný soubor v tomto umístění.

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

Vyhledejte všechny uzly XML v tomto souboru, které odkazují na System.ServiceModel, Version=2.0.0.0, odstraňte je a všechny podřízené uzly. Tento problém vyřešíte uložením souboru a opětovným spuštěním ServiceModelReg.exe.

Examples

Následující příklady ukazují, jak používat nejběžnější možnosti nástroje ServiceModelReg.exe.

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