워크플로 서비스 등록 도구(WFServicesReg.exe)

아티클
05/10/2023

워크플로 서비스 등록 도구(WFServicesReg.exe)는 Windows WF(Workflow Foundation) 서비스의 구성 요소를 추가, 제거 또는 복구하는 데 사용할 수 있는 독립 실행형 도구입니다.

구문

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

설명

이 도구는 .NET Framework 3.5 설치 위치(특히 %windir%\Microsoft.NET\Framework\v3.5) 또는 %windir%\Microsoft.NET\Framework64\v3.5(64비트 시스템의 경우)에 있습니다.

다음 표에서는 워크플로 서비스 등록 도구(WFServicesReg.exe)에서 사용할 수 있는 옵션에 대해 설명합니다.

옵션	Description
`/c`	Windows Workflow Services를 구성합니다. 설치 및 복구 시나리오에서 사용됩니다.
`/r`	Windows Workflow Services 구성을 제거합니다.
`/v`	구성 또는 제거에 대한 자세한 정보를 인쇄합니다.
`/m`	MSI 로깅 형식을 사용합니다.
`/i`	애플리케이션이 실행될 때 창을 최소화합니다.

등록

이 도구는 Web.config 파일을 검사하고 다음을 등록합니다.

.NET Framework 3.5 참조 어셈블리입니다.
.xoml 파일의 빌드 공급자
.xoml 및 .rules 파일의 HTTP 처리기

이 도구는 Machine.config 파일을 검사하고 다음 확장을 등록합니다.

behaviorExtensions
bindingElementExtensions
bindingExtensions

또한 다음과 같은 클라이언트 메타데이터 가져오기를 등록합니다.

policyImporters
wsdlImporters

이 도구는 또한 IIS 메타베이스에 .xoml과 .rules 스크립트 맵 및 처리기를 등록합니다.

Windows Server 2003 및 Windows XP 컴퓨터(IIS 5.1 및 IIS 6.0)에서는 .xoml과 .rules 스크립트 맵 집합 하나가 등록됩니다.

64비트 시스템에서 도구는 Enable32BitAppOnWin64 스위치를 사용할 수 있는 경우 WOW 모드 스크립트 맵을 등록하고, Enable32BitAppOnWin64 스위치를 사용할 수 없는 경우 네이티브 64비트 스크립트 맵을 등록합니다.

Windows Vista 및 Windows Server 2008(IIS 7.0 이상) 시스템에서는 .xoml과 .rules 처리기 집합 두 개가 등록됩니다. 하나는 통합 모드용이고 하나는 클래식 모드용입니다.

64비트 시스템에서는 Enable32BitAppOnWin64 스위치의 상태에 관계없이 처리기 집합 세 개가 등록됩니다. 하나는 통합 모드용, 하나는 WOW 클래식 모드용, 하나는 네이티브 64비트 클래식 모드용입니다.

참고

ServiceModelreg.exe와 달리 WFServicesReg.exe에서는 특정 웹 사이트에 대한 스크립트 맵이나 처리기를 추가, 제거 또는 복구할 수 없습니다. 이러한 문제의 해결 방법에 대해서는 "스크립트 맵 복구" 단원을 참조하십시오.

사용 시나리오

.NET Framework 3.5 설치 후 IIS 설치

Windows Server 2003 컴퓨터에서는 IIS를 설치하기 전에 .NET Framework 3.5가 설치됩니다. IIS를 사용할 수 없으므로 .xoml 및 .rules 스크립트 맵을 설치하지 않아도 .NET Framework 3.5가 설치됩니다.

IIS가 설치된 후에는 /c 스위치와 함께 WFServicesReg.exe 도구를 사용하여 이러한 특정 스크립트 맵을 설치할 수 있습니다.

스크립트 맵 복구

웹 사이트 노드에서 삭제된 스크립트 맵

Windows Server 2003 시스템에서 .xoml이나 .rules가 웹 사이트 노드에서 실수로 삭제된 경우입니다. 이런 경우 /c 스위치와 함께 WFServicesReg.exe 도구를 실행하여 복구할 수 있습니다.

특정 웹 사이트에서 삭제된 스크립트 맵

Windows Server 2003 시스템에서 .xoml이나 .rules가 웹 사이트 노드가 아닌 특정 웹 사이트(예: 기본 웹 사이트)에서 실수로 삭제된 경우입니다.

특정 웹 사이트에 대해 삭제된 처리기를 복구하려면 “WFServicesReg.exe /r”을 실행하여 모든 웹 사이트에서 처리기를 제거한 다음, “WFServicesReg.exe /c”를 실행하여 모든 웹 사이트에 적합한 처리기를 만들어야 합니다.

IIS 모드 전환 후 처리기 구성

IIS가 공유 구성 모드에 있는 경우 .NET Framework 3.5를 설치하면 IIS 메타베이스가 공유 위치에 구성됩니다. IIS를 비공유 구성 모드로 전환하면 로컬 메타베이스에 필요한 처리기가 포함되지 않습니다. 로컬 메타베이스를 제대로 구성하려면 공유 메타베이스를 로컬로 가져오거나 로컬 메타베이스를 구성하는 “WFServicesReg.exe /c”를 실행할 수 있습니다.

다음을 통해 공유