특정 일반적인 오류 사례의 경우 웹 배포는 문제 해결을 위해 추가 정보를 가져오는 데 유용할 수 있는 메시지와 오류 코드를 표시합니다. 오류 코드의 전체 목록은 웹 배포 오류 코드를 참조 하세요.
참고 항목
오류 메시지는 웹 배포가 호출되는 방법에 따라 다를 수 있습니다. 예를 들어 Microsoft WebMatrix는 오류 코드 대신 사용자 지정 오류 메시지를 표시하도록 선택하는 반면, 명령줄에는 오류 코드가 기록된 경우 항상 오류 코드가 표시됩니다.
설치 문제
1. 유효한 OS에 웹 배포를 설치할 수 없습니다.
증상
운영 체제(OS)가 올바르고 웹 배포의 버전과 비트가 올바르지만 설치는 성공하지 못합니다.
근본 원인
Unknown
수정/해결 방법
%programfiles%\IIS\Microsoft Web Deploy V3에 있는 설치 로그를 확인합니다.
2. 업그레이드 후 웹 배포가 작동하지 않음
증상
버전 업그레이드 후에는 웹 배포가 작동하지 않습니다.
근본 원인
웹 배포는 업그레이드 후 서비스를 다시 시작하지 않습니다.
수정/해결 방법
기존 웹 배포 설치를 업그레이드하는 경우 관리 명령 프롬프트에서 다음 명령을 실행하여 처리기 및 에이전트 서비스를 다시 시작해야 합니다. net stop msdepsvc net start msdepsvc net stop wmsvc net start wmsvc
3. 64비트 하드웨어에 웹 배포 32비트 버전을 설치할 수 없습니다.
증상
근본 원인
64비트 OS에 32비트를 설치하는 것은 WoW64 모드를 지원하지 않기 때문에 실패하는 웹 배포 MSI 내의 확인입니다.
수정/해결 방법
OS의 아키텍처와 일치하는 동일한 버전을 설치합니다.
4. 32비트 하드웨어에 웹 배포 64비트 버전을 설치할 수 없습니다.
증상
근본 원인
32비트 OS에 64비트를 설치하려고 하면 웹 배포의 MSI 내에서 오류가 발생하는지 확인합니다.
수정/해결 방법
OS의 아키텍처와 일치하는 동일한 버전을 설치합니다.
5. 기존 네임스페이스로 인해 URL 네임스페이스를 등록할 수 없습니다.
증상
웹 배포를 설치할 수 없습니다.
근본 원인
설치하는 동안 웹 배포에서 만들려고 시도하는 URL 네임스페이스가 이미 등록되어 있습니다.
수정/해결 방법
- 충돌하는 등록을 제거합니다. - 설치하는 동안 웹 배포 URL 변경 msiexec /i wdeploy.msi /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/. URL 사용자 지정에 대한 자세한 내용은 원격 서비스 사용자 지정 및 보안을 참조하세요.
원격 에이전트 서비스 문제
1. 시작하는 동안 Microsoft.Web.Deployment.Dll을 초기화할 수 없습니다.
증상
원격 에이전트 서비스를 시작하지 못합니다.
근본 원인
%programfiles%\IIS\Microsoft Web Deploy v3에서 msdepsvc.exe 또는 기타 파일이 없습니다.
수정/해결 방법
제품을 다시 설치합니다.
2. 원격 에이전트 서비스가 시작되지 않음
증상
Microsoft.Web.Deployment.DeploymentAgentUnavailableException: 원격 에이전트(URL http://DestinationServer/msdeployagentservice)에 연결할 수 없습니다. 원격 에이전트 서비스가 대상 컴퓨터에 설치되고 시작되었는지 확인합니다. >--- System.Net.WebException: 원격 서버에서 (404) 찾을 수 없음 오류를 반환했습니다.
근본 원인
원격 에이전트 서비스가 시작되지 않았습니다.
수정/해결 방법
서비스를 시작합니다 net start msdepsvc.
3. HTTP가 수신 대기 중이거나 허용되지 않는 서버에 연결하려고 합니다.
증상
Microsoft.Web.Deployment.DeploymentAgentUnavailableException: 원격 에이전트(URL http://DestinationServer/msdeployagentservice)에 연결할 수 없습니다. 원격 에이전트 서비스가 대상 컴퓨터에 설치되고 시작되었는지 확인합니다. >--- System.Net.WebException: System.Net.Sockets.SocketException을 ---> 원격 서버에 연결할 수 없습니다. 대상 컴퓨터에서 DestinationServer:80을 적극적으로 거부했기 때문에 연결할 수 없습니다.
근본 원인
HTTP가 수신 대기하고 있지 않습니다.
수정/해결 방법
원격 에이전트 서비스에 대한 HTTP 트래픽이 허용되는지 확인합니다.
4. 메서드가 허용되지 않음 오류로 서버에 연결하려고 시도
증상
Microsoft.Web.Deployment.DeploymentException: 원격 에이전트 URL ''http://DestinationServer/에 대한 요청을 완료할 수 없습니다. >--- System.Net.WebException: 원격 서버에서 (405) 메서드가 허용되지 않음 오류를 반환했습니다.
근본 원인
msdepsvc.exe 경로가 누락되어 MS Deploy 대신 인터넷 정보 서비스(IIS) 자체에서 요청을 선택했습니다.
수정/해결 방법
을 포함하도록 URL을 변경합니다 /MSDeployAgentService.
5. 관리자가 아닌 원격 에이전트 서비스에 액세스하려고 시도
증상
Microsoft.Web.Deployment.DeploymentException: 원격 에이전트 URL ''http://DestinationServer/msdeployAgentService에 대한 요청을 완료할 수 없습니다. >---; System.Net.WebException: 원격 서버에서 (401) 권한 없음 오류를 반환했습니다.
근본 원인
원격 에이전트 서비스를 사용하려면 호출자가 Administrators 그룹의 구성원이거나 Administrators 그룹에 추가된 도메인 계정에서 있어야 합니다. 기본 제공 계정이 아닌 로컬 관리자는 웹 배포 2.0의 버그로 인해 원격 에이전트 서비스에서 작동하지 않습니다.
수정/해결 방법
관리 자격 증명을 제공합니다.
6. 작업 중 원격 에이전트 서비스가 중단됩니다.
증상
서비스는 최대 몇 시간 동안 응답을 중지할 수 있습니다.
근본 원인
‘알 수 없음’.
수정/해결 방법
작업을 중지하고 반복하려고 시도합니다.
7. 클라이언트와 서버가 호환되지 않음(버전 불일치)
증상
Timestamp=24638007621418 MsDepSvc.exe 오류: 0: 오류가 발생했습니다. 예외 세부 정보는 다음과 같습니다. Microsoft.Web.Deployment.DeploymentClientServerException: 클라이언트와 서버가 호환되지 않습니다. 클라이언트에서 지원하는 가장 낮은 버전은 '7.1.538.0'입니다. 서버에서 지원하는 가장 높은 버전은 '7.1.537.0'입니다.
근본 원인
일부 버전은 함께 작동하지 않으므로 웹 배포는 함께 작동하지 않습니다. 일반적으로 시험판 버전이 릴리스 버전에서 작동하지 않도록 차단하기 위해 수행됩니다.
수정/해결 방법
버전과 일치합니다.
8. 원격 에이전트 서비스가 URL에서 수신 대기를 시작할 수 없습니다.
증상
원격 에이전트 서비스가 URL ''{0}에서 수신 대기를 시작할 수 없습니다. URL이 사용되지 않는지 확인합니다.
근본 원인
일반적으로 URL 충돌을 나타냅니다.
수정/해결 방법
기본 URL을 원하는 경우 다시 설치하거나 설명서에 지정된 대로 사용자 지정 URL을 설정해 보세요. URL 사용자 지정에 대한 자세한 내용은 원격 서비스 사용자 지정 및 보안을 참조하세요.
웹 관리 서비스 문제
1. 웹 관리 서비스가 시작되지 않음
증상
웹 관리 서비스가 시작되지 않았습니다.
근본 원인
‘알 수 없음’. 서비스는 기본적으로 시작되어야 합니다.
수정/해결 방법
웹 관리 서비스 서비스를 시작합니다 Net Start WMSVC.
2. 권한 없음: 배포 처리기 규칙에 의해 권한이 부여되지 않은 사용자
증상
웹 관리 서비스를 사용하여 연결할 때 지정된 공급자 <ProviderName> 으로 작업을 완료할 수 없습니다. 서버 관리자가 이 작업에 대해 사용자에게 권한을 부여하지 않은 경우 이 문제가 발생할 수 있습니다.
근본 원인
관리자가 아닌 사용자가 공급자를 사용하여 제한된 작업을 수행하려고 했습니다. 이 작업은 일반적으로 일치하는 위임 규칙을 찾을 수 없음을 나타냅니다. 사용자 이름, 공급자, 작업 또는 공급자 경로가 잘못되었습니다.
수정/해결 방법
해결 방법은 위임 규칙을 수정하거나 만드는 것입니다. 위임 규칙에 대한 자세한 내용은 웹 배포 처리기 구성을 참조 하세요.
Visual Studio에서 게시할 때 오류 발생
Visual Studio에서 웹 배포를 통해 올바르게 구성되지 않은 서버에 게시하려고 할 때 발생할 수 있는 일반적인 오류 문제를 해결하는 방법에 대한 자세한 내용은 Visual Studio의 웹 배포 문제 해결을 참조하세요.
