Outil WorkFlow Service Registration (WFServicesReg.exe)
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).
Syntaxe
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.3.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 .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 machines Windows Server 2003 et Windows XP (IIS 5.1 et IIS 6.0), un ensemble de scripts .xoml et .rules est inscrit.
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 machines Windows Vista et 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.
Notes
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
Sur une machine Windows Server 2003, .NET Framework 3.5 est installé avant l’installation d’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
Sur une machine 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
Sur une machine 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 « WFServicesReg.exe /r » afin de supprimer les gestionnaires de tous les sites web, puis « WFServicesReg.exe /c » afin de créer les gestionnaires appropriés à tous les sites web.
Configuration de gestionnaires après activation du mode IIS
Lorsque les services IIS sont en mode de configuration partagé et que .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 localement la métabase partagée, soit exécuter « WFServicesReg.exe /c », qui configure la métabase locale.