ServiceModel 註冊工具 (ServiceModelReg.exe)

  • 發行項

這個命令列工具可讓您在單一電腦上管理 WCF 及 WF 元件的註冊。 在一般情況下，您應該不需要使用這個工具，因為安裝時已對 WCF 及 WF 元件進行設定。 但如果您遇到服務啟用的問題，您可以嘗試使用這個工具來註冊元件。

語法

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

備註

您可以在下列位置找到這個工具：

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

注意

當 ServiceModel 註冊工具在 Windows Vista 上執行時，[Windows 功能] 對話方塊可能不會反映Microsoft .NET Framework 3.0底下的[Windows Communication Foundation HTTP 啟用] 選項已開啟。 按一下 [開始]，然後按一下 [執行]，再輸入 OptionalFeatures，即可存取 [Windows 功能] 對話方塊。

下表說明可與 ServiceModelReg.exe 搭配使用的選項。

選項 描述
-ia 安裝所有 WCF 和 WF 元件。
-ua 解除安裝所有 WCF 和 WF 元件。
-r 修復所有 WCF 和 WF 元件。
-i 安裝使用 –c 所指定的 WCF 和 WF 元件。
-u 解除安裝使用 –c 所指定的 WCF 和 WF 元件。
-c 安裝或解除安裝元件：

- httpnamespace – HTTP 命名空間保留
- tcpportsharing – TCP 通訊埠共用服務
- tcpactivation – .NET 4 用戶端設定檔) 不支援 TCP 啟用服務 (
- nameDPIpeactivation - .NET 4 用戶端設定檔不支援的具名管道啟用服務 (
- msmqactivation – .NET 4 用戶端設定檔不支援 MSMQ 啟用服務 (
- etw – ETW 事件追蹤資訊清單 (Windows Vista 或更高版本)
-q 無訊息模式 (僅顯示錯誤記錄)
-v 詳細資訊模式。
-nologo 不顯示版權和橫幅訊息。
-? 顯示說明文字

修正 FileLoadException 錯誤

如果電腦上已安裝舊版的 WCF，執行 ServiceModelReg 工具註冊新安裝時，可能會收到 FileLoadFoundException 錯誤。 即使您已手動移除舊安裝中的檔案，但 machine.config 設定仍保留原封不動，仍將發生這種情形。

得到的錯誤訊息與以下類似。

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'

您會在錯誤訊息中發現，先前發行的 Customer Technology Preview (CTP) 安裝了 System.ServiceModel Version 2.0.0.0 組件。 System.ServiceModel 組件目前的版本是 3.0.0.0。 因此，若電腦曾安裝舊版 WCF CTP 且未完全解除安裝，在安裝 WCF 的正式版時，便會遇到這個錯誤。

ServiceModelReg.exe 無法清除舊版的項目，也無法註冊新版本項目。 唯一的解決方法就是手動編輯 machine.config。您可以在下列位置找到這個檔案。

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

如果您在 64 位元的電腦上執行 WCF，可以在這個位置編輯相同的檔案。

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

在這個檔案中找出任何參考「System.ServiceModel, Version=2.0.0.0」的 XML 節點，刪除這些節點及其所有子節點。 儲存檔案並重新執行 ServiceModelReg.exe，便可解決這個問題。

範例

下列範例顯示如何使用 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