다음을 통해 공유


Azure Windows VM 에이전트 문제 해결

적용 대상: ✔️ Windows VM

참고

이 문서가 도움이 되었나요? 귀하의 입력은 우리에게 중요합니다. 이 페이지의 피드백 단추를 사용하여 이 문서가 얼마나 잘 작동했는지 또는 어떻게 개선할 수 있는지 알려주세요.

참고

새로운! 빠른 진단을 위한 VM 지원 시도

Windows용 VM 지원 또는 Linux용 VM 지원을 실행하는 것이 좋습니다. 이러한 스크립트 기반 진단 도구는 Azure VM 게스트 에이전트 및 전체 VM 상태에 영향을 주는 일반적인 문제를 식별하는 데 도움이 됩니다.

Azure VM 에이전트는 VM(가상 머신) 에이전트입니다. 이를 통해 VM은 IP 주소 168.63.129.16에서 패브릭 컨트롤러(VM이 호스트되는 기본 물리적 서버)와 통신할 수 있습니다. 이 주소는 통신을 용이하게 하는 가상 공용 IP 주소입니다. 자세한 내용은 IP 주소 168.63.129.16이란? 페이지를 참조하세요.

온-프레미스 환경에서 Azure로 마이그레이션되거나 사용자 지정된 이미지를 사용하여 만든 VM에는 Azure VM 에이전트가 설치되어 있지 않습니다. 이러한 시나리오에서는 VM 에이전트를 수동으로 설치해야 합니다. VM 에이전트를 설치하는 방법에 대한 자세한 내용은 Azure Virtual Machine 에이전트 개요를 참조하세요.

Azure VM 에이전트가 성공적으로 설치되면 VM의 services.msc에 나열된 다음 서비스를 볼 수 있습니다.

서비스 설명
Windows Azure 게스트 에이전트 이 서비스는 게스트 VM에서 호스트 에이전트로의 다양한 확장 및 통신을 구성합니다. 또한 WaAppAgent.log 로그를 수집해야 합니다.
원격 분석 이 서비스는 VM의 원격 분석 데이터를 백 엔드 서버로 보내는 역할을 담당합니다.
RdAgent 이 서비스는 게스트 에이전트 설치를 담당합니다. (투명한 설치 관리자는 게스트 에이전트의 다른 구성 요소 및 서비스를 업그레이드하는 데 도움이 되는 RdAgent의 또 다른 구성 요소입니다.) 또한 RdAgent는 게스트 VM에서 실제 서버의 호스트 에이전트로 하트비트를 보내는 역할을 담당합니다.

참고

게스트 에이전트의 버전 2.7.41491.971부터 원격 분석 구성 요소가 Windows Azure 게스트 에이전트 서비스에 포함됩니다. 따라서 새로 만든 VM에 나열된 원격 분석 서비스가 표시되지 않을 수 있습니다.

문제 해결 검사 목록

모든 VM 확장을 실행하려면 Azure VM 게스트 에이전트를 설치하고 성공적으로 작동해야 합니다. 게스트 에이전트가 준비되지 않은 것으로 보고되거나 확장이 실패하고 오류 VMAgentStatusCommunicationError메시지를 반환하는 경우 다음 단계에 따라 게스트 에이전트 문제 해결을 시작합니다.

1단계: VM이 시작되었는지 확인

VM이 시작되었는지 확인하려면 다음 단계를 수행합니다.

  1. Azure Portal에서 가상 머신을 검색하여 선택합니다.

  2. VM 목록에서 Azure VM의 이름을 선택합니다.

  3. Azure VM의 탐색 창에서 개요를 선택합니다.

  4. VM이 아직 실행되고 있지 않은 경우 개요 페이지의 맨 위에 있는 작업 목록을 찾은 다음 시작 링크를 선택합니다.

또한 운영 체제(OS)가 시작되고 성공적으로 실행되고 있는지 확인합니다.

2단계: 게스트 에이전트가 준비되었는지 확인

Azure Portal의 VM 개요 페이지에 있는 동안 속성 탭을 선택합니다. 에이전트 상태 필드준비 값이 있는 경우 에이전트 버전 필드 값이 지원되는 최소 버전을 충족하는지 확인합니다. 다음 스크린샷은 이러한 필드를 찾을 수 있는 위치를 보여줍니다.

VM(가상 머신) 속성을 보여 주는 Azure Portal 스크린샷 에이전트 상태가 준비 상태이고 에이전트 버전은 2.7.41491.1083입니다.

게스트 에이전트 상태가 준비되었지만 VM 확장과 관련된 문제가 있는 경우 Azure 가상 머신 확장 및 기능을 참조하여 문제 해결 제안을 검토하세요.

게스트 에이전트 상태가 준비 되지 않았거나 비어 있으면 게스트 에이전트가 설치되지 않았거나 제대로 작동하지 않습니다.

3단계: 게스트 에이전트 서비스가 실행 중인지 확인

  1. RDP(원격 데스크톱 프로토콜)를 사용하여 VM에 연결합니다.

    참고

    RDP 연결이 성공적으로 작동하려면 게스트 에이전트를 설치하고 실행할 필요가 없습니다. VM에 대한 RDP 연결에 영향을 주는 문제가 발생하는 경우 Azure 가상 머신에 대한 원격 데스크톱 연결 문제 해결을 참조하세요.

  2. VM에서 시작을 선택하고 services.msc검색한 다음 서비스 앱을 선택합니다.

  3. 서비스 창에서 RdAgent 서비스를 선택합니다.

  4. 작업 메뉴를 선택한 다음 속성을 선택합니다.

  5. 속성 대화 상자의 일반 탭에서 다음 조건이 true인지 확인한 다음 확인 또는 취소 단추를 선택합니다.

    • 시작 유형 목록이 자동으로 설정됩니다.
    • 서비스 상태 필드에는 실행 값이 있습니다.

    RdAgent 속성 대화 상자의 스크린샷 대화 상자에는 RdAgent 서비스 상태가 실행 중으로 표시되고 시작 유형이 자동으로 표시됩니다.

  6. 서비스 창에서 WindowsAzureGuestAgent 서비스를 선택합니다.

  7. 4단계와 5단계를 반복합니다.

서비스가 없으면 게스트 에이전트가 설치되지 않을 수 있습니다. 이 경우 게스트 에이전트를 수동으로 설치할 수 있습니다. 수동 설치 를 하기 전에 설치 필수 구성 요소를 확인합니다.

4단계: WireServer 연결 테스트

성공적으로 실행하려면 게스트 에이전트가 포트 168.63.129.1680.의 WireServer IP(호스트 IP) 주소 32526 에 연결해야 합니다. 이 IP 주소에 대한 연결을 테스트하는 지침은 IP 주소 168.63.129.16의연결 문제 해결 섹션을 참조하세요.

해당 섹션의 테스트 중에서 연결을 만들지 않는 경우 다음 구성 요소 중에서 IP 주소 168.63.129.16에 대한 액세스를 차단할 수 있는 문제를 확인합니다.

  • 방화벽
  • 프록시
  • 애플리케이션

5단계: 로그 파일 검토

주목할 만한 오류는 다음 로그 위치를 확인합니다.

  • C:\WindowsAzure\Logs\WaAppAgent.log
  • C:\WindowsAzure\Logs\TransparentInstaller.log

일반적인 오류 시나리오

Azure VM 에이전트가 준비되지 않은 상태를 표시하거나 예상대로 작동을 중지할 수 있는 다음과 같은 일반적인 시나리오와 찾은 오류를 비교합니다.

WireServer IP에 연결할 수 없음(168.63.129.16)

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

다음 오류 항목은 WaAppAgent.log 파일에 기록됩니다.

[ERROR] GetVersions() failed with exception: Microsoft.ServiceModel.Web.WebProtocolException: Server Error: Service Unavailable (ServiceUnavailable) ---> 
System.Net.WebException: The remote server returned an error: (503) Server Unavailable.
[00000011] [12/11/2018 06:27:55.66] [WARN]  (Ignoring) Exception while fetching supported versions from HostGAPlugin: System.Net.WebException: Unable to connect to the remote server 
---> System.Net.Sockets.SocketException: An attempt was made to access a socket in a way forbidden by its access permissions 168.63.129.16:32526
at System.Net.Sockets.Socket.DoConnect(EndPoint endPointSnapshot, SocketAddress socketAddress)
at System.Net.ServicePoint.ConnectSocketInternal(Boolean connectFailure, Socket s4, Socket s6, Socket& socket, IPAddress& address, ConnectSocketState status, IAsyncResult asyncResult, Exception& exception)
--- End of inner exception stack trace ---
at System.Net.WebClient.DownloadDataInternal(Uri address, WebRequest& request)
at System.Net.WebClient.DownloadString(Uri address)
at Microsoft.GuestAgentHostPlugin.Client.GuestInformationServiceClient.GetVersions()
at Microsoft.WindowsAzure.GuestAgent.ContainerStateMachine.HostGAPluginUtility.UpdateHostGAPluginAvailability()`

이러한 오류 항목은 VM이 WireServer IP 주소 168.63.129.16에 도달할 수 없음을 나타냅니다.

해결 방법: DHCP를 사용하도록 설정하고 서버가 방화벽, 프록시 또는 기타 원본에 의해 차단되지 않도록 합니다.

  1. 원격 데스크톱을 사용하여 VM에 연결한 다음 168.63.129.16에 대한 연결을 테스트합니다. Azure IP 주소 168.63.129.16 개요연결 문제 해결 섹션을 참조하세요.
  2. VM의 네트워크 어댑터에 개인 IP가 하나만 있는 경우 게스트 VM에서 DHCP를 사용하도록 설정하는 것이 좋습니다. 고정 개인 IP 주소가 필요한 경우 Azure Portal 또는 PowerShell을 통해 구성해야 하며 VM 내 DHCP 옵션을 사용할 수 있는지 확인합니다. IP 구성이 항상 Azure의 VM에 대한 구성과 일치하도록 하려면 PowerShell 을 사용하여 고정 IP 주소를 설정하는 방법을 알아봅니 다.
  3. VM의 네트워크 어댑터에 할당된 개인 IP가 여러 개인인 경우 단계를 신중하게 수행하여 IP 구성을 올바르게 할당해야 합니다. 단계를 완료한 후 게스트 에이전트가 168.63.129.16과 통신할 수 없는 경우 Windows의 기본 IP가 Azure의 VM 네트워크 어댑터에 있는 기본 IP와 일치하는지 확인합니다.
  4. 방화벽, 프록시 또는 다른 원본이 IP 주소 168.63.129.16에 대한 액세스를 차단할 수 있는 문제를 확인합니다.
  5. Windows 방화벽 또는 타사 방화벽이 포트 8032526에 대한 액세스를 차단하는지 확인합니다. 이 주소를 차단 하지 않아야 하는 이유에 대한 자세한 내용은 IP 주소 168.63.129.16이란?

게스트 에이전트가 "중지" 프로세스에서 중단됨

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

다음 오류 항목은 WaAppAgent.log 파일에 기록됩니다.

[00000007] [07/18/2019 14:46:28.87] [WARN] WindowsAzureGuestAgent stopping.
[00000007] [07/18/2019 14:46:28.89] [INFO] Uninitializing StateExecutor with WaitForTerminalStateReachedOnEnd : True
[00000004] [07/18/2019 14:46:28.89] [WARN] WindowsAzureGuestAgent could not be stopped. Exception: System.NullReferenceException: Object reference not set to an instance of an object.
at Microsoft.WindowsAzure.GuestAgent.ContainerStateMachine.GoalStateExecutorBase.WaitForExtensionWorkflowComplete(Boolean WaitForTerminalStateReachedOnEnd)
at Microsoft.WindowsAzure.GuestAgent.ContainerStateMachine.GoalStateExecutorBase.Uninitialize(Boolean WaitForTerminalStateReachedOnEnd)
at Microsoft.WindowsAzure.GuestAgent.ContainerStateMachine.GoalStateExecutorForCloud.Uninitialize(Boolean WaitForTerminalStateReachedOnEnd)
at Microsoft.WindowsAzure.GuestAgent.AgentCore.AgentCore.Stop(Boolean waitForTerminalState)
at Microsoft.WindowsAzure.GuestAgent.AgentCore.AgentService.DoStopService()
at Microsoft.WindowsAzure.GuestAgent.AgentCore.AgentService.<>c__DisplayClass2.<OnStopProcessing>b__1()

이러한 오류 항목은 Azure VM 에이전트가 "중지" 프로세스에서 중단되었음을 나타냅니다.

해결 방법 A: WaAppAgent.exe 시작하고 WindowsAzureGuest.exe 중지

WaAppAgent.exe VM에서 실행되고 있는지 확인합니다. 실행되지 않는 경우 RdAgent 서비스를 다시 시작한 다음 5분 정도 기다립니다. WaAppAgent.exe 실행을 시작한 후 WindowsAzureGuest.exe 프로세스를 종료합니다.

솔루션 B: Azure VM 에이전트 업그레이드

솔루션 A가 문제를 해결하지 못하는 경우 현재 설치된 버전을 제거한 다음 에이전트 의 최신 버전을 수동으로 설치합니다.

Npcap 루프백 어댑터가 설치됨

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

다음 오류 항목은 WaAppAgent.log 파일에 기록됩니다.

[00000006] [06/20/2019 07:44:28.93] [INFO] Attempting to discover fabric address on interface Npcap Loopback Adapter
[00000024] [06/20/2019 07:44:28.93] [WARN] Empty DHCP option data returned
[00000006] [06/20/2019 07:44:28.93] [ERROR] Did not discover fabric address on interface Npcap Loopback Adapter

이러한 오류 항목은 WiresharkVM에 Nmap(네트워크 매퍼) 프로젝트의 Npcap(패킷 캡처) 루프백 어댑터를 설치했음을 나타냅니다. Wireshark는 네트워크 트래픽을 프로파일링하고 패킷을 분석하기 위한 오픈 소스 도구입니다. 이러한 도구를 네트워크 분석기, 네트워크 프로토콜 분석기 또는 스니퍼라고도 합니다.

해결 방법: Npcap 루프백 어댑터 사용 안 함

Npcap 루프백 어댑터를 사용하지 않도록 설정한 다음 문제가 해결되었는지 확인합니다.

RPC(원격 프로시저 호출) 문제 - RdCrypt 초기화 실패

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

다음 오류 항목은 WaAppAgent.log 파일에 기록됩니다.

[00000004] [01/12/2019 00:30:47.24] [ERROR] RdCrypt Initialization failed. Error Code: -2147023143.
[00000004] [01/12/2019 00:30:47.24] [ERROR] Failed to get TransportCertificate. Error: System.AccessViolationException
Microsoft.Cis.Fabric.CertificateServices.RdCertificateFactory.Shutdown()
[00000004] [01/12/2019 00:30:47.24] [WARN]  Could not get transport certificate from agent runtime for subject name: 12345678-d7c8-4387-8cf3-d7ecf62544e5. Installing certificates in the LocalMachine store failed.
[00000004] [01/12/2019 00:30:47.24] [WARN] Fetching certificate blob from the cert URI: http://168.63.129.16/machine/12345678-d7c8-4387-8cf3-d7ecf62544e5/12345678-d447-4b10-a5da-1ba1581cd7d7._VMName?comp=certificates&incarnation=2 failed with exception: System.NullReferenceException
-2147023143 = 0x6d9 = EPT_S_NOT_REGISTERED

이러한 오류는 RPC(원격 프로시저 호출) 문제로 인해 발생할 수 있습니다. 예를 들어 RPC 엔드포인트가 수신 대기하지 않거나 RPC 프로세스가 반대쪽 끝에 없을 수 있습니다.

해결 방법: CNG 키 격리 서비스 시작

CNG(Cryptography Next Generation) 키 격리(CNGKEYISO) Windows 서비스가 RPC 엔드포인트 목록에 있는지 확인합니다. 이렇게 하려면 다음 portqry 명령을 실행합니다.

portqry -n <VMName> -e 135

프로세스가 표시되지 CNGKEYISO 않으면 Windows 서비스 콘솔(CNG 키 격리 = KeyIso)에서 시작한 다음 WaAppAgent.exe 다시 시작하거나 WindowsAzureGuestAgent.exe.

PInvoke PFXImportCertStore가 실패하고 null 핸들이 반환됩니다. 오류 코드: 86

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

Windows 게스트 에이전트가 실행 중이지만 확장이 작동하지 않습니다. 다음 오류 항목은 WaAppAgent.log 파일에 기록됩니다.

PInvoke PFXImportCertStore failed and null handle is returned. Error Code: 86

[00000003] [10/21/2020 02:37:45.98] [WARN] Could not get transport certificate from agent runtime for subject name: 12345678-dae3-4c2f-be57-55c0ab7a44e5. Installing certificates in the LocalMachine store failed.
[00000003] [10/21/2020 02:37:45.98] [ERROR] Installing certificates in the LocalMachine store failed with exception: Microsoft.WindowsAzure.GuestAgent.CertificateManager.CryptographyNative+PInvokeException: PInvoke PFXImportCertStore failed and null handle is returned. Error Code: 86.

이러한 오류는 SYSTEM 계정에 대한 Crypto 폴더에 대한 권한이 부족하여 발생할 수 있습니다. 게스트 에이전트 서비스(RdAgent 또는 WindowsAzureGuestAgent)를 다시 시작하는 동안 프로세스 모니터(ProcMon) 추적을 수집하는 경우 몇 가지 "액세스 거부" 오류를 볼 수 있습니다.

해결 방법: SYSTEM 계정에 Crypto 폴더의 모든 권한 추가

SYSTEM 계정에 다음 폴더에 대한 모든 권한이 있는지 확인합니다.

  • C:\ProgramData\Microsoft\Crypto\Keys

  • C:\ProgramData\Microsoft\Crypto\RSA

  • C:\ProgramData\Microsoft\Crypto\SystemKeys

System.BadImageFormatException: 잘못된 형식의 프로그램을 로드하려고 했습니다. (HRESULT 예외: 0x8007000B)

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

게스트 에이전트가 응답하지 않음을 나타내기 위해 다음 오류 항목이 WaAppAgent.log 파일에 기록됩니다.

[00000018] 2021-01-12T16:35:45Z [INFO]  Test extract the plugin zip file to the temp folder C:\TEMP\12345678-5f85-45dc-9f17-55be1fde7b10
[00000010] 2021-01-12T16:35:45Z [ERROR] InstallPlugins() failed with exception: System.AggregateException: One or more errors occurred. ---> System.BadImageFormatException: An attempt was made to load a program with an incorrect format. (Exception from HRESULT: 0x8007000B)
   at Microsoft.WindowsAzure.GuestAgent.ExtensionStateMachine.PluginInstaller.PackageExpand(String packageFilePath, String destinationPath)
   at Microsoft.WindowsAzure.GuestAgent.ExtensionStateMachine.PluginInstaller.ValidateExtensionZipFile(String pluginName, String pluginVersion, String& pluginZipFile)

타사 애플리케이션이 VM에 설치되어 있고 32비트 또는 64비트 .NET 애플리케이션의 동작을 수정했기 때문에 이러한 오류가 발생할 가능성이 높습니다.

BadImageFormatException 64비트 애플리케이션에서 32비트 DLL을 로드할 때 오류가 발생합니다.

해결 방법: .NET Framework에 대한 Enable64Bit 레지스트리 항목을 설정하고 VM을 다시 시작합니다.

Important

이 절, 방법 또는 작업에는 레지스트리를 수정하는 방법에 대한 단계가 포함되어 있습니다. 그러나 레지스트리를 잘못 수정하면 심각한 문제가 발생할 수 있습니다. 따라서 다음 단계를 주의하여 수행해야 합니다. 보호하기 위해 레지스트리를 수정하기 전에 백업하여 문제가 발생할 경우 레지스트리를 복원할 수 있도록 합니다. 레지스트리를 백업 및 복원하는 방법에 대한 자세한 내용은 Windows에서 레지스트리를 백업 및 복원하는 방법을 참조하세요.

레지스트리를 열고 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\를 찾습니다. NETFramework 레지스트리 하위 키를 클릭한 다음 Enable64Bit 레지스트리 항목을 봅니다.

Enable64Bit 레지스트리 항목이 0으로 설정된 경우 64비트 .NET 애플리케이션은 32비트 애플리케이션으로 간주됩니다. 따라서 Azure VM 에이전트가 작동하지 않습니다.

해결 방법은 Enable64Bit 키를 1설정한 다음 VM을 다시 시작하는 것입니다.

ConfigurationErrorsException 또는 TypeInitializationException 오류로 인해 Windows 게스트 에이전트가 시작되지 않음

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

Windows 게스트 에이전트는 시작 시 응답을 중지하고 다음 애플리케이션 로그 항목이 기록됩니다.

Log Name:      Application
Source:        .NET Runtime
Date:          3/07/2023 10:25:59 AM
Event ID:      1026
Task Category: None
Level:         Error
Keywords:      Classic
User:          N/A
Computer:      vm372437823
Description:
Application: WindowsAzureGuestAgent.exe
Framework Version: v4.0.30319
Description: The process was terminated due to an unhandled exception.
Exception Info: System.Configuration.ConfigurationErrorsException
   at System.Configuration.ConfigurationSchemaErrors.ThrowIfErrors(Boolean)
   at System.Configuration.BaseConfigurationRecord.ThrowIfParseErrors(System.Configuration.ConfigurationSchemaErrors)
   at System.Configuration.ClientConfigurationSystem.EnsureInit(System.String)

Exception Info: System.Configuration.ConfigurationErrorsException
   at System.Configuration.ClientConfigurationSystem.EnsureInit(System.String)
   at System.Configuration.ClientConfigurationSystem.PrepareClientConfigSystem(System.String)
   at System.Configuration.ClientConfigurationSystem.System.Configuration.Internal.IInternalConfigSystem.GetSection(System.String)
   at System.Configuration.ConfigurationManager.GetSection(System.String)
   at System.Configuration.PrivilegedConfigurationManager.GetSection(System.String)
   at System.Diagnostics.DiagnosticsConfiguration.GetConfigSection()
   at System.Diagnostics.DiagnosticsConfiguration.Initialize()
   at System.Diagnostics.DiagnosticsConfiguration.get_IndentSize()
   at System.Diagnostics.TraceInternal.InitializeSettings()
   at System.Diagnostics.Trace.set_AutoFlush(Boolean)
   at Microsoft.WindowsAzure.GuestAgent.Prime.TraceManager..cctor()

Exception Info: System.TypeInitializationException
   at Microsoft.WindowsAzure.GuestAgent.Prime.TraceManager.Write(System.String, System.Object[])
   at Microsoft.WindowsAzure.GuestAgent.AgentCore.AgentCore.Start()
   at System.Threading.ExecutionContext.RunInternal(System.Threading.ExecutionContext, System.Threading.ContextCallback, System.Object, Boolean)
   at System.Threading.ExecutionContext.Run(System.Threading.ExecutionContext, System.Threading.ContextCallback, System.Object, Boolean)
   at System.Threading.ExecutionContext.Run(System.Threading.ExecutionContext, System.Threading.ContextCallback, System.Object)
   at System.Threading.ThreadHelper.ThreadStart()

이 문제는 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config 파일이 없거나 손상된 경우에 발생할 수 있습니다.

해결 방법: 작동하는 Machine.config 파일을 VM에 복사한 다음 게스트 에이전트 서비스를 다시 시작합니다.

이 문제를 해결하려면 다음 단계를 따릅니다.

  1. 작업 중인 VM에서 Machine.config 파일을 복사한 다음 문제가 있는 VM 의 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config 폴더에 파일을 붙여넣습니다.

  2. 다음 net stop 명령을 실행하여 게스트 에이전트 서비스를 다시 시작 net start 합니다.

    net stop RdAgent
    net stop WindowsAzureGuestAgent
    
    net start RdAgent
    net start WindowsAzureGuestAgent
    

게스트 에이전트 설치 실패

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

게스트 에이전트 설치에 실패하는 경우 게스트 에이전트에 대한 모든 필수 구성 요소가 충족되는지 확인합니다.

Windows 게스트 에이전트 제거 및 다시 설치

  1. 게스트 에이전트가 설치되어 있는지 여부를 프로그램 추가/제거를 체크 인합니다.

메모: 게스트 에이전트가 .msi 설치 관리자를 통해 수동으로 설치된 경우 에이전트는 프로그램 추가/제거에 표시됩니다. 이미지 프로비전 중에 게스트 에이전트가 설치된 경우 에이전트는 프로그램 추가/제거에 표시되지 않습니다.

  1. 게스트 에이전트가 프로그램 추가/제거에 있는 경우 해당 위치에서 제거합니다. 그런 다음 이 단계의 명령줄 인수를 사용하여 .msi 파일을 통해 설치할 수 있습니다.

  2. 에이전트가 설치되어 있지만 프로그램 추가/제거에 표시되지 않는 경우 다음 단계를 수행합니다.

    1. 관리자 권한 명령 프롬프트 창을 엽니다.
    2. 게스트 에이전트 서비스를 중지합니다. 서비스가 중지되지 않으면 서비스를 수동 시작으로 설정한 다음 VM을 다시 시작해야 합니다.
    net stop rdagent
    net stop WindowsAzureGuestAgent
    
    1. 게스트 에이전트 서비스 삭제
    sc delete rdagent
    sc delete WindowsAzureGuestAgent
    
    1. C:\WindowsAzure에서 폴더를 만들고 OLD로 이름을 지정합니다.
    2. Packages 또는 GuestAgent라는 폴더를 OLD 폴더로 이동합니다.
    3. .msi 설치 위치(C:\VMAgentMSI)에 대한 새 폴더를 만듭니다.
  3. Windows 게스트 에이전트용 GitHub 릴리스에서 최신 .msi 파일을 다운로드합니다.

  4. msiexec 명령줄 + 인수를 사용하여 게스트 에이전트를 설치합니다.

    msiexec.exe /i c:\VMAgentMSI\WindowsAzureVmAgent.2.7.<version>.fre.msi /L*v C:\Windows\Panther\msiexec.log
    
  5. 설치에 실패하면 다음 파일을 수집하여 실패한 이유를 조사합니다.

    • C:\Windows\Panther\msiexec.log
    • C:\Windows\Panther\VmAgentInstaller.xml

WMI 오류로 인해 게스트 에이전트 설치 실패

문제 해결 세부 정보를 보려면 여기를 클릭하세요.
  1. Windows 게스트 에이전트용 GitHub 릴리스에서 최신 .msi 파일을 다운로드합니다.

  2. msiexec 명령줄 + 인수를 사용하여 게스트 에이전트 설치

    msiexec.exe /i c:\VMAgentMSI\WindowsAzureVmAgent.2.7.<version>.fre.msi /L*v C:\Windows\Panther\msiexec.log
    
  3. 설치에 실패하면 다음 파일을 수집하여 실패한 이유를 조사합니다.

    • C:\Windows\Panther\msiexec.log
    • C:\Windows\Panther\VmAgentInstaller.xml

게스트 에이전트를 설치하려고 할 때 MSIEXEC.log 및 VmAgentInstaller.xml 다음 오류 메시지를 찾을 수 있습니다.

MSIEXEC.log:

Action start 12:11:03: CA2.
MSI (s) (7C:A8) [12:27:20:328]: Note: 1: 1722 2: CA2 3: wscript.exe 4: "C:\Program Files\Windows Azure VM Agent v2.7.41491.949\\InstallOrUpdateGA.vbs"
MSI (s) (7C:A8) [12:27:20:328]: Note: 1: 2205 2:  3: Error
MSI (s) (7C:A8) [12:27:20:328]: Note: 1: 2228 2:  3: Error 4: SELECT `Message` FROM `Error` WHERE `Error` = 1722
CustomAction CA2 returned actual error code 1 (note this may not be 100% accurate if translation happened inside sandbox)
MSI (s) (7C:A8) [12:27:22:707]: Note: 1: 2205 2:  3: Error
MSI (s) (7C:A8) [12:27:22:707]: Note: 1: 2228 2:  3: Error 4: SELECT `Message` FROM `Error` WHERE `Error` = 1709
MSI (s) (7C:A8) [12:27:22:707]: Product: Windows Azure VM Agent - 2.7.41491.949 -- Error 1722. There is a problem with this Windows Installer package. A program run as part of the setup did not finish as expected. Contact your support personnel or package vendor.  Action CA2, ___location: wscript.exe, command: "C:\Program Files\Windows Azure VM Agent v2.7.41491.949\\InstallOrUpdateGA.vbs"

C:\Windows\Panther\VmAgentInstaller.xml:

Event time="2019-12-12T12:49:05.123Z" category="INFO" source="GuestAgent"><SetRdAgentServicePathInRegistry ServiceName="RdAgent" ServiceImagePath="C:\WindowsAzure\Packages_20191212_124856\WaAppAgent.exe"/></Event>
<Event time="2019-12-12T12:49:05.163Z" category="ERROR" source="GuestAgent"><UnhandledError><Message>Setting the new RdAgent service path in registry failed.</Message><Number>424</Number><Description>Object required</Description><Source>Microsoft VBScript runtime error</Source></UnhandledError></Event>
<Event time="2019-12-12T12:49:05.203Z" category="ERROR" source="GuestAgent"><ConfigureRdAgentService/></Event>
<Event time="2019-12-12T12:49:05.258Z" category="ERROR" source="GuestAgent"><UnhandledError><Message>Installing the RdAgent service failed.</Message><Number>-2147467259</Number><Description>This name may not contain the ' ' character:

VM 에이전트 .msi 파일은 WMI StdRegProv를 사용하여 레지스트리에 액세스합니다. WMI가 제대로 작동하지 않는 경우 .msi 파일은 레지스트리에서 RdAgent 서비스 경로를 설정할 수 없습니다. 따라서 .msi 파일 설치가 실패합니다.

해결 방법

  1. 관리자 권한 명령 프롬프트 창을 엽니다.
  2. WMI StdRegProv가 작동하는지 테스트하려면 다음 WMIC 명령을 실행하고 출력을 텍스트 파일에 복사합니다.
wmic /namespace:\\root\default Class StdRegProv Call GetDWORDValue hDefKey="&H80000002" sSubKeyName="SYSTEM\CurrentControlSet\Services\Winmgmt" sValueName=Start

Windows Server 2025 이상을 사용 중이고 WMIC를 수동으로 설치하지 않은 경우 관리자 권한 PowerShell 창을 열어 StdRegProv를 테스트합니다.

Invoke-CimMethod -ClassName StdRegProv -MethodName GetDWORDValue -Arguments @{sSubKeyName = 'SYSTEM\CurrentControlSet\Services\Winmgmt';sValueName = 'Start'}
  1. 다음 WINMGMT 명령을 실행하여 WMI 리포지토리를 확인하고 출력을 텍스트 파일에 복사합니다.
winmgmt /verifyrepository
  1. WMI 리포지토리 백업:
xcopy c:\windows\system32\wbem\repository c:\windows\system32\wbem\repository.bak /e /i
  1. 다음 명령을 실행하여 WMI 문제를 해결하고 출력을 텍스트 파일에 복사합니다.
winmgmt /salvagerepository
  1. VM 에이전트 .msi 설치를 다시 시도합니다. 성공적으로 완료되면 1~2분 동안 기다린 다음 RdAgent 서비스가 실행 중인지 확인합니다.
wmic service rdagent list brief
  1. WMIC 명령에 RdAgent가 실행 중임을 표시하는 경우 문제를 해결해야 합니다. WMIC 명령이 실패하거나 RdAgent가 실행되고 있지 않음을 표시하는 경우 다음 단계로 이동합니다.

  2. 다음 명령을 실행하여 WMI 리포지토리를 다시 설정합니다.

net stop winmgmt /y
winmgmt /resetrepository
net start winmgmt
  1. VM 에이전트 .msi 설치를 다시 시도합니다. 성공적으로 완료되면 1~2분 동안 기다린 다음 RdAgent 서비스가 실행 중인지 확인합니다.
wmic service rdagent list brief
  1. 이 시점에서 WMIC 명령이 실패하거나 RdAgent 가 실행 중임을 표시하지 않는 경우 검토를 위해 C:\Windows\Panther\VMAgentInstall.xml 파일을 Microsoft 지원에 보냅니다.

Windows Azure 게스트 에이전트 서비스 또는 RdAgent 서비스가 시작 시 응답을 중지합니다.

문제 해결 세부 정보를 보려면 여기를 클릭하세요.

시스템 이벤트 오류 7031 또는 7034가 기록되고 C:\WindowsAzure\logs\TransparentInstaller.log 다음 항목이 표시됩니다.

[ERROR] System.Configuration.ConfigurationErrorsException: The type 'Microsoft.VisualStudio.Diagnostics.ServiceModelSink.Behavior, Microsoft.VisualStudio.Diagnostics.ServiceModelSink, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' registered for extension 'Microsoft.VisualStudio.Diagnostics.ServiceModelSink.Behavior' could not be loaded.

(C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config line 242)

해결 방법

이 문제는 WCF(Windows Communication Framework) 프로파일링을 사용하는 경우에 발생할 수 있습니다. WCF 문제를 디버그하는 동안에만 WCF 프로파일링을 사용하도록 설정해야 합니다. 프로덕션 워크로드를 실행하는 동안에는 사용하도록 설정하면 안 됩니다.

WCF 프로파일링을 사용하지 않도록 설정하려면 다음을 수행합니다.

  • 관리자 권한 명령 프롬프트 창을 엽니다.
  • 기존 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config 파일을 백업하려면 다음 명령을 실행합니다.
cd C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config
copy machine.config machine.config.bak
  • 메모장에서 파일을 편집하려면 다음을 실행합니다 notepad machine.config. 다음 텍스트를 제거합니다(하지만 동일한 줄에 있을 수 있는 다른 텍스트도 제거하지 않도록 주의하세요.)
<add name="Microsoft.VisualStudio.Diagnostics.ServiceModelSink.Behavior" type="Microsoft.VisualStudio.Diagnostics.ServiceModelSink.Behavior, Microsoft.VisualStudio.Diagnostics.ServiceModelSink, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>

다음 텍스트를 제거합니다(하지만 동일한 줄에 있을 수 있는 다른 텍스트도 제거하지 않도록 주의하세요.)

<commonBehaviors><endpointBehaviors><Microsoft.VisualStudio.Diagnostics.ServiceModelSink.Behavior/></endpointBehaviors><serviceBehaviors><Microsoft.VisualStudio.Diagnostics.ServiceModelSink.Behavior/></serviceBehaviors></commonBehaviors>
  • 파일을 저장 후 닫습니다.
  • 게스트 에이전트 서비스를 다시 시작합니다.
net stop Rdagent
net stop WindowsAzureGuestAgent

net start Rdagent
net start WindowsAzureGuestAgent
  • 경우에 따라 WCF 사용 안 함을 적용하려면 VM을 다시 시작해야 할 수 있습니다.

다음 단계

Azure VM 에이전트와 연결된 다른 알려진 문제는 GitHub 리포지토리에 나열됩니다.

타사 정보 고지 사항

이 문서에 나와 있는 다른 공급업체 제품은 Microsoft와 무관한 회사에서 제조한 것입니다. Microsoft는 이들 제품의 성능이나 안정성에 관하여 명시적이든 묵시적이든 어떠한 보증도 하지 않습니다.

타사 연락처 고지

이 문서에 포함된 타사의 연락처 정보는 이 항목에 대한 추가 정보를 찾는 데 도움을 주기 위한 것입니다. 이 연락처 정보는 공지 없이 변경될 수 있습니다. Microsoft는 타사 연락처 정보의 정확성을 보증하지 않습니다.

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.