Ferramenta de registro de serviço de fluxo de trabalho (WFServicesReg.exe)

  • Artigo

A ferramenta de Registro de Serviços de Fluxo de Trabalho (WFServicesReg.exe) é uma ferramenta autônoma que pode ser usada para adicionar, remover ou reparar os elementos de configuração dos serviços do WF (Windows Workflow Foundation).

Sintaxe

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

Comentários

A ferramenta pode ser encontrada no local de instalação do .NET Framework 3.5, especificamente, %windir%\Microsoft.NET\Framework\v3.5 ou em %windir%\Microsoft.NET\Framework64\v3.5 em computadores de 64 bits.

As tabelas a seguir descrevem as opções usadas com a ferramenta de Registro de Serviços de Fluxo de Trabalho (WFServicesReg.exe).

Opção Descrição
/c Configura os Serviços de Fluxo de Trabalho do Windows. Usado em cenários de instalação e reparo.
/r Remove a configuração dos Serviços de Fluxo de Trabalho do Windows.
/v Imprima informações verbose (para configuração ou remoção).
/m Habilita o formato de registro em log do MSI.
/i Minimiza a janela quando o aplicativo é executado.

Registro

A ferramenta inspeciona o arquivo Web.config e registra o seguinte:

  • Assemblies de referência do .NET Framework 3.5.

  • Um provedor de build para arquivos .xoml.

  • Manipuladores HTTP para arquivos .xoml e .rules.

A ferramenta inspeciona o arquivo Machine.config e registra as seguintes extensões:

  • behaviorExtensions

  • bindingElementExtensions

  • bindingExtensions

A ferramenta também registra os seguintes importadores de metadados do cliente:

  • policyImporters

  • wsdlImporters

A ferramenta também registra scripts e manipuladores .xoml e .rules na metabase do IIS.

Em computadores Windows Server 2003 e Windows XP (IIS 5.1 e IIS 6.0), um conjunto de scripts .xoml e .rules são registrados.

Em computadores de 64 bits, a ferramenta registrará scripts de modo WOW se o switch Enable32BitAppOnWin64 estiver habilitado ou scripts nativos de 64 bits se o switch Enable32BitAppOnWin64 estiver desabilitado.

Em computadores Windows Vista e Windows Server 2008 (IIS 7.0 e superior), dois conjuntos de manipuladores .xoml e .rules são registrados: um para modo integrado e outro para o modo Clássico.

Em computadores de 64 bits, três conjuntos de manipuladores são registrados (independentemente do estado do switch Enable32BitAppOnWin64): um para o modo integrado, um para o modo WOW Classic e outro para o modo clássico nativo de 64 bits.

Observação

Ao contrário de ServiceModelreg.exe, WFServicesReg.exe não permite adicionar, remover ou reparar mapas de script ou manipuladores para um site específico. Para ver uma solução alternativa para esse problema, consulte a seção "Reparar os mapas de script".

Cenários de uso

Instalação do IIS após a instalação do .NET Framework 3.5

Em um computador Windows Server 2003, o .NET Framework 3.5 é instalado antes do IIS. Devido à indisponibilidade da metabase do IIS, é possível instalaçr o .NET Framework 3.5 sem instalar os mapas de script .xoml e .rules.

Depois que o IIS for instalado, você poderá usar a ferramenta WFServicesReg.exe com o switch /c para instalar esses scripts específicos.

Reparar os mapas de script

Mapa de script excluído no nó Sites

Em um computador Windows Server 2003, as regras .xoml ou .são excluídas acidentalmente do nó sites. Isso pode ser reparado executando a ferramenta WFServicesReg.exe com o switch /c.

Mapa de script excluído em um site específico

Em um computador Windows Server 2003, as regras .xoml ou .são excluídas acidentalmente de um site específico (por exemplo, o Site Padrão) em vez do nó sites.

Para reparar manipuladores excluídos de um determinado site, você deve executar "WFServicesReg.exe /r" para remover manipuladores de todos os sites e, em seguida, executar "WFServicesReg.exe /c" para criar os manipuladores apropriados para todos os sites.

Configurando manipuladores depois de alternar o modo IIS

Quando o IIS está no modo de configuração compartilhado e .NET Framework 3.5 é instalado, a metabase do IIS é configurada em um local compartilhado. Se você alternar o IIS para o modo de configuração não compartilhado, a metabase local não conterá os manipuladores necessários. Para configurar a metabase local corretamente, você pode importar a metabase compartilhada para local ou executar "WFServicesReg.exe /c", que configura a metabase local.