Outil WorkFlow Service Registration (WFServicesReg.exe)

Article
09/12/2008

Workflow Services Registration (WFServicesReg.exe) est un outil autonome qui peut être utilisé pour ajouter, supprimer ou réparer les éléments de configuration correspondant aux services Windows Workflow Foundation (WF).

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

Notes

Cet outil se trouve à l'emplacement d'installation de .NET Framework 3.5, c'est-à-dire %windir%\Microsoft.NET\Framework\v3.5 ou %windir%\Microsoft.NET\Framework64\v3.5 pour les ordinateurs 64 bits.

Les tableaux suivants décrivent les options pouvant être utilisées avec l'outil Workflow Services Registration (WFServicesReg.exe).

Option	Description
/c	Configure les services de workflow Windows. Utilisé dans les scénarios d'installation et de réparation.
/r	Supprime la configuration des services de workflow Windows.
/v	Imprimez des informations détaillées (pour la configuration ou la suppression).
/m	Active le format d'enregistrement MSI.
/i	Réduit la fenêtre lorsque l'application est exécutée.

Inscription

L'outil vérifie le fichier Web.config et enregistre les éléments suivants :

Assemblys de référence de .NET Framework 3.5.
Fournisseur de version pour fichiers .xoml.
Gestionnaires HTTP pour fichiers .xoml et .rules.

L'outil vérifie le fichier Machine.config et enregistre les extensions suivantes :

behaviorExtensions
bindingElementExtensions
bindingExtensions

L'outil enregistre également les importateurs de métadonnées clients suivants :

policyImporters
wsdlImporters

L'outil enregistre également des mappages de scripts .xoml et .rules ainsi que des gestionnaires dans la métabase IIS.

Sur les ordinateurs sous Windows Server 2003 et Windows XP (IIS 5.1 et IIS 6.0), un jeu de mappages de scripts .xoml et .rules est enregistré.

Sur les ordinateurs 64 bits, l'outil enregistre les mappages de scripts en mode WOW si le commutateur Enable32BitAppOnWin64 est activé, ou les mappages de scripts 64 bits natifs si le commutateur Enable32BitAppOnWin64 est désactivé.

Sur les ordinateurs sous Windows Vista et sous Windows Server 2008 (IIS 7.0 et versions ultérieures), deux jeux de gestionnaires .xoml et .rules sont enregistrés : un pour le mode intégré et l'autre pour le mode classique.

Sur les ordinateurs 64 bits, trois jeux de gestionnaires sont enregistrés (indépendamment de l'état du commutateur Enable32BitAppOnWin64) : un pour le mode intégré, un pour le mode classique WOW et le dernier pour le mode classique 64 bits natif.

Remarque :
Contrairement à ServiceModelReg.exe, WFServicesReg.exe n'autorise pas l'ajout, la suppression ou la réparation des mappages de scripts ou des gestionnaires correspondant à un site Web particulier. Pour contourner ce problème, consultez la section « Réparation des mappages de scripts ».

Scénarios d'utilisation

Installation des services IIS après l'installation de .NET Framework 3.5

Sous Windows Server 2003, .NET Framework 3.5 est installé avant les services IIS. En raison de l'indisponibilité de la métabase IIS, l'installation de .NET Framework 3.5 aboutit sans installer les mappages de scripts .xoml et .rules.

Après avoir installé les services IIS, vous pouvez utiliser l'outil WFServicesReg.exe avec le commutateur /c pour installer ces mappages de scripts spécifiques.

Réparation des mappages de scripts

Mappage de scripts supprimé sous le nœud Sites Web

Sous Windows Server 2003, le mappage de scripts .xoml ou .rules est supprimé par erreur du nœud Sites Web. Ce problème peut être résolu en exécutant l'outil WFServicesReg.exe avec le commutateur /c.

Mappage de scripts supprimé sous un site Web particulier

Sous Windows Server 2003, un mappage de scripts .xoml ou .rules est supprimé par erreur d'un site Web particulier (celui par défaut, par exemple) et non du nœud Sites Web.

Pour réparer des gestionnaires supprimés d'un site Web particulier, exécutez « /r WFServicesReg.exe » afin de supprimer des gestionnaires de tous les sites Web, puis « /c WFServicesReg.exe » pour créer les gestionnaires appropriés à tous les sites Web.

Configuration de gestionnaires après activation du mode IIS

Si les services IIS sont en mode de configuration partagé et si .NET Framework 3.5 est installé, la métabase IIS est configurée sous un emplacement partagé. Si vous basculez IIS en mode de configuration non partagé, la métabase locale ne contiendra pas les gestionnaires requis. Pour configurer correctement la métabase locale, vous pouvez soit importer en local la métabase partagée, soit exécuter « /c WFServicesReg.exe », qui configure la métabase locale.

Share via