WorkFlow 服務登錄工具 (WFServicesReg.exe)

Workflow 服務登錄工具 (WFServicesReg.exe) 是一個獨立工具,可用於新增、移除或修復 Windows Workflow Foundation (WF) 服務的組態項目。

語法

WFServicesReg.exe [-c | -r | -v | -m | -i]  

備註

此工具可在 .NET Framework 3.5 安裝位置找到,特別是 %windir%\Microsoft.NET\Framework\v3.5,或位於 64 位電腦的 %windir%\Microsoft.NET\Framework64\v3.5。

下表描述可與 Workflow 服務登錄工具 (WFServicesReg.exe) 搭配使用的選項。

選項 描述
/c 設定 Windows 工作流程服務。 用於安裝和修復案例中。
/r 移除 Windows 工作流程服務組態。
/v 列印詳細資訊 (適用於設定或移除)。
/m 啟用 MSI 記錄格式。
/i 應用程式執行時,最小化視窗。

註冊

工具會檢查 Web.config 檔案並註冊下列項目:

  • .NET Framework 3.5 參考元件。

  • .xoml 檔案的組建提供者。

  • .xoml 和 .rules 檔案的 HTTP 處理常式。

工具會檢查 Machine.config 檔案並註冊下列延伸項目:

  • behaviorExtensions

  • bindingElementExtensions

  • bindingExtensions

工具也會註冊下列用戶端中繼資料匯入工具:

  • policyImporters

  • wsdlImporters

工具也會在 IIS Metabase 中註冊 .xoml 和 .rules Scriptmap 與處理常式。

Windows Server 2003 和 Windows XP 機器 (IIS 5.1 和 IIS 6.0) 上會註冊一組 .xoml 和 .rules scriptmap。

在 64 位元電腦上,如果已啟用 Enable32BitAppOnWin64 參數,此工具就會註冊 WOW 模式 Scriptmap,如果已停用 Enable32BitAppOnWin64 參數,則會註冊原生 64 位元 Scriptmap。

在 Windows Vista 和 Windows Server 2008 (IIS 7.0 (含) 以上版本) 電腦上,註冊兩組 .xoml 和 .rules 處理常式:一組用於整合模式,一組用於傳統模式。

在 64 位元電腦上,會註冊三組處理常式 (無論 Enable32BitAppOnWin64 參數的狀態為何):一組用於整合模式,一組用於 WOW 傳統模式,一組用於原生 64 位元傳統模式。

注意

與 ServiceModelreg.exe 不同的是,WFServicesReg.exe 不允許新增、移除或修復用於特定網站的 Scriptmap 或處理常式。 如需這個問題的解決方法,請參閱「修復 Scriptmap」一節。

使用案例

在安裝 .NET Framework 3.5 之後安裝 IIS

在 Windows Server 2003 電腦上安裝 .NET Framework 3.5,再安裝 IIS。 由於 IIS 中繼基底無法使用,.NET Framework 3.5 的安裝會成功,而不需要安裝 .xoml 和 .rules scriptmap。

安裝 IIS 之後,您可以使用 WFServicesReg.exe 工具搭配 /c 參數來安裝這些特定 Scriptmap。

修復 Scriptmap

在網站節點下刪除的 Scriptmap

在 Windows Server 2003 機器上,從 [網站] 節點意外刪除了 .xoml 或 .rules。 您可以使用 /c 參數執行 WFServicesReg.exe 工具修復這種情況。

在特定網站下刪除的 Scriptmap

在 Windows Server 2003 機器上,從特定網站 (例如 [預設的網站],而不是從 [網站] 節點) 意外刪除了 .xoml 或 .rules。

若要修復特定網站的已刪除處理常式,您應該執行 "WFServicesReg.exe /r" 以移除所有網站的處理常式,然後執行 "WFServicesReg.exe /c",為所有網站建立適當處理常式。

在切換 IIS 模式之後設定處理常式

當 IIS 處於共用組態模式,並安裝 .NET Framework 3.5 時,IIS 中繼基底會設定在共用位置之下。 如果將 IIS 切換為非共用組態模式,本機 Metabase 將不會包含所需的處理常式。 若要正確地設定本機 Metabase,您可以匯入共用的 Metabase 至本機,或執行 "WFServicesReg.exe /c",以設定本機 Metabase。