이 문서에서는 Windows 또는 Linux용 Azure Connected Machine 에이전트를 구성하는 동안 발생할 수 있는 문제 해결에 대한 정보를 제공합니다. 서비스에 대한 연결을 구성할 때 대화형 및 대규모 설치 방법에 대한 팁이 포함되어 있습니다.
일반적인 내용은 Azure Arc 지원 서버 개요, Azure Connected Machine 에이전트 개요 및 Connected Machine 에이전트 관리 및 유지 관리를 참조하세요.
에이전트 오류 코드
다음 표를 사용하여 Azure Connected Machine 에이전트를 구성할 때 발생하는 문제를 식별하고 해결합니다. 콘솔 또는 스크립트 출력에는 오류 코드가 AZCM0000 표시됩니다. 여기서 "0000"은 4자리 숫자일 수 있습니다.
| 오류 코드 | 가능한 원인: | 제안된 수정 사항 |
|---|---|---|
| AZCM0000 | 작업이 성공적으로 완료되었습니다. | 해당 없음 |
| AZCM0001 | 알 수 없는 오류가 발생했습니다. | Microsoft 지원팀에 도움을 요청하십시오. |
| AZCM0002 | 에이전트에서 내부 오류가 발생했습니다. | 에이전트 서비스(HIMDS)를 다시 시작하고 다시 시도합니다. 문제가 지속되면 Microsoft 지원에 문의하세요. |
| AZCM0003 | 요청된 작업은 지원되지 않습니다. | 명령이 운영 체제 및 에이전트 버전에 유효한지 확인합니다. |
| AZCM0004 | Azure Arc 프록시 서비스가 실행되고 있지 않습니다. | HIMDS(Hybrid Instance Metadata Service)가 실행 중인지 확인하고 다시 시도합니다. |
| AZCM0005 | 사용할 수 있는 파일 로거 없음 | 로그 디렉터리가 있고 충분한 디스크 공간과 권한이 있는지 확인합니다. |
| AZCM0006 | 에이전트 초기화 실패 | 필수 구성 요소(네트워크 연결, 권한)를 확인한 다음, 명령을 다시 실행합니다. |
| AZCM0011 | 사용자가 작업을 취소했습니다(CTRL+C). | 이전 명령을 다시 시도합니다. |
| AZCM0012 | 액세스 토큰이 잘못되었습니다. | 액세스 토큰을 통해 인증하는 경우 새 토큰을 가져와서 다시 시도합니다. 서비스 주체 또는 디바이스 로그인을 통해 인증하는 경우 Microsoft 지원에 문의하여 도움을 받으세요. |
| AZCM0016 | 필수 매개 변수가 없음 | 출력된 오류 메시지를 검토하여 누락된 매개 변수를 확인합니다. 명령의 전체 구문에 대해 azcmagent <command> --help를 실행합니다. |
| AZCM0018 | 명령이 관리자 권한을 사용하지 않고 실행되었습니다. | 권한이 상승된 사용자 컨텍스트(관리자/루트)에서 명령을 다시 시도합니다. |
| AZCM0019 | 구성 파일의 경로가 잘못되었습니다. | 구성 파일의 경로가 올바른지 확인하고 다시 시도합니다. |
| AZCM0020 | 알 수 없는 지역이 지정되었습니다. | 지역 이름에서 오타가 있는지 확인하고 지역이 지원되는지 확인합니다. |
| AZCM0023 | 매개 변수(인수)에 제공된 값이 잘못되었습니다. | 오류 메시지에서 자세한 정보를 확인합니다. 인수에 대한 유효한 값 또는 예상 형식은 명령 구문(azcmagent <command> --help)을 참조하세요. |
| AZCM0026 | 네트워크 구성에 오류가 발생하거나 일부 중요한 서비스를 일시적으로 사용할 수 없습니다. | 필요한 엔드포인트에 연결할 수 있는지 확인합니다(예: 호스트 이름은 확인할 수 있고 엔드포인트는 차단되지 않음). 네트워크가 Private Link 범위에 대해 구성된 경우 --private-link-scope 매개 변수를 사용하여 온보딩하기 위해 Private Link 범위 리소스 ID를 제공해야 합니다. |
| AZCM0027 | 구성 충돌이 감지되었습니다. | 에이전트 구성 파일에서 충돌하는 설정을 제거하고 다시 시도합니다. |
| AZCM0028 | TPM 디바이스를 열지 못했습니다. | TPM(신뢰할 수 있는 플랫폼 모듈)이 활성화되고 액세스할 수 있는지 확인한 다음 다시 시도하세요. |
| AZCM0041 | 제공된 자격 증명이 잘못되었습니다. | 디바이스 로그인의 경우 서버 리소스가 만들어질 테넌트 및 구독에 대한 액세스 권한이 지정된 사용자 계정에 있는지 확인합니다. 서비스 주체 로그인의 경우 클라이언트 ID와 비밀에서 정확성 및 유효한 만료 날짜를 확인하고 서비스 주체가 서버 리소스를 만들 동일한 테넌트에 있는지 확인합니다. |
| AZCM0042 | Azure Arc 지원 서버 리소스를 만들지 못함 | 출력의 오류 메시지를 검토하여 리소스를 만들지 못한 원인 및 제안된 수정을 알아봅니다. 자세한 내용은 필요한 권한 참조하세요. |
| AZCM0043 | Azure Arc 지원 서버 리소스를 삭제하지 못함 | 지정된 사용자 또는 서비스 주체에 지정된 그룹의 Azure Arc 사용 가능한 서버 또는 리소스를 삭제할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 필요한 권한 참조하세요. 리소스가 더 이상 Azure에 없으면 --force-local-only 플래그를 사용하여 계속 진행합니다. |
| AZCM0044 | 이름이 같은 리소스가 이미 있습니다. | 다른 이름을 --resource-name 매개 변수에 지정하거나 Azure에서 기존 Azure Arc 지원 서버를 삭제하고 다시 시도합니다. |
| AZCM0045 | 다시 연결할 새 공개 키로 서비스를 업데이트하지 못했습니다. | 네트워크 연결을 확인한 다음 다시 시도합니다. 자세한 내용은 에이전트 로그를 검토합니다. |
| AZCM0061 | 에이전트 서비스가 응답하지 않거나 사용할 수 없습니다. | 권한이 상승된 사용자 컨텍스트(관리자/루트)에서 명령이 실행되는지 확인합니다. HIMDS 서비스가 실행 중인지 확인(필요에 따라 HIMDS를 시작하거나 다시 시작)한 다음, 명령을 다시 시도합니다. |
| AZCM0062 | 서버를 연결하는 동안 오류가 발생했습니다. | 더 자세한 내용은 출력된 오류 메시지를 검토합니다. Azure 리소스를 만든 후 오류가 발생한 경우 다시 시도하기 전에 이 리소스를 삭제합니다. |
| AZCM0063 | 서버 연결을 끊는 동안 오류가 발생했습니다. | 더 자세한 내용은 출력된 오류 메시지를 검토합니다. 이 오류가 계속되면 Azure에서 리소스를 삭제한 다음, 서버에서 azcmagent disconnect --force-local-only를 실행합니다. |
| AZCM0064 | 에이전트 서비스가 응답하지 않거나 사용할 수 없습니다. | 권한이 상승된 사용자 컨텍스트(관리자/루트)에서 명령이 실행되는지 확인합니다. HIMDS 서비스가 실행 중인지 확인(필요에 따라 HIMDS를 시작하거나 다시 시작)한 다음, 명령을 다시 시도합니다. |
| AZCM0065 | 에이전트 서비스가 응답하지 않거나 사용할 수 없습니다. | 권한이 상승된 사용자 컨텍스트(관리자/루트)에서 명령이 실행되는지 확인합니다. HIMDS 서비스가 실행 중인지 확인(필요에 따라 HIMDS를 시작하거나 다시 시작)한 다음, 명령을 다시 시도합니다. |
| AZCM0066 | 에이전트 서비스가 응답하지 않거나 사용할 수 없습니다. | 권한이 상승된 사용자 컨텍스트(관리자/루트)에서 명령이 실행되는지 확인합니다. HIMDS 서비스가 실행 중인지 확인(필요에 따라 HIMDS를 시작하거나 다시 시작)한 다음, 명령을 다시 시도합니다. |
| AZCM0067 | 머신이 이미 Azure에 연결되어 있습니다. |
azcmagent disconnect를 실행하여 현재 연결을 제거한 다음, 다시 시도합니다. |
| AZCM0068 | 구독 이름이 제공되었고 해당 구독 GUID를 조회하는 동안 오류가 발생했습니다. | 구독 이름 대신 구독 GUID를 사용하여 명령을 다시 시도합니다. |
| AZCM0069 | 로컬 구성 업데이트를 완료하는 동안 오류가 발생했습니다. | 에이전트 구성 디렉터리에 대한 파일 권한을 확인하고 다시 시도합니다. |
| AZCM0070 | 에이전트 서비스가 응답하지 않거나 사용할 수 없습니다. | 권한이 상승된 사용자 컨텍스트(관리자/루트)에서 명령이 실행되는지 확인합니다. HIMDS 서비스가 실행 중인지 확인(필요에 따라 HIMDS를 시작하거나 다시 시작)한 다음, 명령을 다시 시도합니다. |
| AZCM0072 | 확장 도구를 실행하는 동안 오류가 발생했습니다. | 자세한 내용은 확장 로그를 검토하고 다시 시도합니다. |
| AZCM0073 | 파트너 구성 속성을 가져올 수 없음 | 파트너 통합 설정의 유효성을 검사하고 다시 시도합니다. |
| AZCM0074 | 확장을 추가하는 동안 오류가 발생했습니다. | 확장 패키지가 유효한지 확인하고 다시 시도합니다. |
| AZCM0075 | 클라우드 구성을 가져올 수 없음 | 필요한 Azure 엔드포인트에 대한 연결을 확인하고 다시 시도합니다. |
| AZCM0076 | TPM 기반 인증을 사용하여 컴퓨터를 Azure 연결하지 못했습니다. | TPM(신뢰할 수 있는 플랫폼 모듈)이 활성화되고 액세스할 수 있는지 확인한 다음 다시 시도하세요. |
| AZCM0081 | Microsoft Entra 관리 ID 인증서를 다운로드하는 동안 오류가 발생했습니다. | 서버를 Azure에 연결하려고 시도하는 동안 이 메시지가 표시되면 에이전트에서 Azure Arc 서비스와 통신할 수 없습니다. Azure에서 리소스를 삭제하고 연결을 다시 시도합니다. |
| AZCM0082 | TPM을 사용하여 HIMDS(Hybrid Instance Metadata Service)에서 관리 ID 인증서를 가져오는 데 실패했습니다. | HIMDS 서비스가 실행 중이고 TPM에 액세스할 수 있는지 확인하고 다시 시도합니다. |
| AZCM0083 | Arc 영구 자격 증명을 서비스에 등록하지 못했습니다. | 네트워크 연결을 확인하고 다시 시도합니다. 자세한 내용은 에이전트 로그를 검토합니다. |
| AZCM0101 | 명령을 실행하는 동안 오류가 발생했습니다. | 명령 구문(azcmagent <command> --help)을 검토하고 에이전트 로그에서 자세한 정보를 확인합니다. |
| AZCM0102 | 컴퓨터 호스트 이름을 검색하는 동안 오류가 발생됨 | 명령을 다시 시도하고 리소스 이름(매개 변수 --resource-name 또는 –n)을 지정합니다. 영숫자, 하이픈 및/또는 밑줄만 사용합니다. 리소스 이름은 하이픈 또는 밑줄로 끝날 수 없습니다. |
| AZCM0103 | RSA 키를 생성하는 동안 오류가 발생했습니다. | Microsoft 지원팀에 도움을 요청하십시오. |
| AZCM0105 | 서명된 메시지를 가져올 수 없습니다. | Azure Arc 서비스에 대한 네트워크 연결을 확인하고 다시 시도합니다. |
| AZCM0107 | 인증서를 검색하지 못했습니다. | 인증서 저장소의 유효성을 검사하고 다시 시도합니다. |
| AZCM0108 | TPM 키를 처리하지 못했습니다. | TPM(신뢰할 수 있는 플랫폼 모듈)이 활성화되고 액세스할 수 있는지 확인한 다음 다시 시도하세요. |
| AZCM0130 | 에이전트에는 systemd가 필요하지만 PATH(Linux)에서 systemctl 명령을 찾을 수 없습니다. |
지원되는 배포판에서 systemd 기반 init 시스템을 사용하세요. |
| AZCM0131 | 설치하는 동안 Linux 배포를 식별할 수 없습니다. | OS가 지원되는 배포인지 확인합니다. |
| AZCM0132 | 프로세서 아키텍처 또는 플랫폼은 지원되지 않습니다(Linux). | 지원되는 플랫폼/아키텍처를 사용합니다. |
| AZCM0133 | Linux 배포판 또는 해당 ARM64 변형은 지원되지 않습니다. | 지원되는 배포 및 아키텍처를 사용합니다. |
| AZCM0141 | Azure 가상 머신(Linux)에 에이전트를 설치할 수 없습니다. | Azure VM은 기본적으로 관리됩니다. 연결된 컴퓨터 에이전트를 설치하지 마세요. 테스트용으로만 https://aka.ms/azcmagent-testwarning를 참조하세요. |
| AZCM0143 | 패키지 관리자(apt/dnf/zypper)가 azcmagent 패키지(Linux)를 설치하지 못했습니다. |
자세한 내용은 패키지 관리자 명령 로그를 검토하고 다시 시도합니다. |
| AZCM0145 | apt/dpkg 잠금은 5분(Linux) 후에도 계속 유지되었습니다. | 다른 apt/dpkg 작업이 실행되고 있지 않은지 확인하고 다시 시도합니다. |
| AZCM0146 | Microsoft 패키지 리포지토리 구성()(packages-microsoft-prodLinux)을 다운로드하지 못했습니다. |
방화벽이 차단 packages.microsoft.com 되고 있는지 확인하고 다시 시도합니다. |
| AZCM0147 | Linux에서 요청 --desiredversion 된 항목을 찾을 수 없습니다. Windows Azure 가상 머신에 에이전트를 설치할 수 없습니다. |
Linux: 사용 가능한 버전을 지정합니다. Windows: Azure VM에 설치하지 마세요(테스트 전용은 참조https://aka.ms/azcmagent-testwarning). |
| AZCM0148 | 에이전트 설치 관리자(.msi)(Windows)를 다운로드하지 못했습니다. | 다운로드 엔드포인트에 대한 네트워크, 프록시, 방화벽 액세스를 확인하고 다시 시도합니다. |
| AZCM0149 | Windows 설치 관리자(msiexec)가 예기치 않은 오류 코드를 반환했습니다. | 설치 로그 및 보고된 msiexec 종료 코드를 검토한 다음 다시 시도합니다. |
| AZCM0150 | 설치하는 동안 일반 오류가 발생했습니다. | 지원 티켓을 제출하여 지원을 받으세요. |
| AZCM0151 | 필요한 .NET Framework 버전이 설치되지 않았습니다(Windows). | 필요한 .NET Framework 버전을 설치하고 다시 시도합니다. |
| AZCM0152 | 서버가 Windows(Azure Stack HCI)를 실행하고 있습니다. | 기본 제공 등록 환경을 사용하여 Azure Arc 연결합니다https://aka.ms/install-arc-on-hci-host. |
| AZCM0153 | 운영 체제 아키텍처는 지원되지 않습니다. 에이전트에는 64비트(x64) OS(Windows)가 필요합니다. | 지원되는 x64 운영 체제에 설치합니다. |
| AZCM0154 | 설치된 PowerShell 버전이 너무 오래되었습니다(Windows). | PowerShell 3.0 이상으로 업그레이드하고 다시 시도합니다. |
| AZCM0155 | 설치가 관리자 권한(Windows)으로 실행되지 않았습니다. | 관리자 권한으로 설치 스크립트를 다시 실행합니다. |
| AZCM0156 | MSI 설치 중 심각한 오류가 발생했습니다(Windows; msiexec 1603). | 자세한 내용은 설치 로그를 %SystemRoot%\AzureConnectedMachineAgent\temp\installationlog.txt 검토하고 다시 시도하세요. |
| AZCM0157 | 권한 오류(Linux)로 인해 설치 관리자를 실행할 curl 수 없습니다. |
curl이(가) 설치 사용자에 의해 설치되어 있고 실행 가능한지 확인한 다음, 다시 시도하세요. |
| AZCM0158 | 디스크 공간 부족(Windows; msiexec 112)으로 인해 설치에 실패했습니다. | 디스크 공간을 확보하고 다시 시도합니다. |
| AZCM0159 | 다른 설치가 이미 진행 중입니다(Windows; msiexec 1618). | 다른 설치가 완료되기를 기다린 다음 다시 시도합니다. |
| AZCM0160 | 설치 관리자가 로그 파일(Windows; msiexec 1622)을 열 수 없습니다. | 로그 디렉터리가 있고 쓰기 가능한지 확인한 다음 다시 시도합니다. |
| AZCM0171 | 에이전트 MSI에서 서명 유효성 검사에 실패했습니다(Windows). | 설치 관리자가 정품 Microsoft 서명된 패키지이고 변조되지 않았는지 확인하고 다시 시도합니다. |
에이전트 종료 코드
Azure 연결된 컴퓨터 에이전트(azcmagent) 명령을 실행하면 프로세스가 종료 코드로 종료될 수 있습니다. 이러한 코드는 작업의 결과를 나타내고 문제를 진단하는 데 도움이 됩니다. 오류 코드와 달리 운영 체제는 에이전트 프로세스가 종료될 때 종료 코드를 반환합니다.
| 종료 코드 | Description | 제안된 수정 |
|---|---|---|
| 0 | 오류가 발생하지 않았습니다. | 작업이 필요하지 않습니다. |
| 1 | 기본 오류입니다. | 필수 구성 요소가 충족되었는지 확인하고, 에이전트 로그를 확인하고, 다시 시도합니다. |
| 2 | 에이전트의 내부 오류입니다. | 에이전트 서비스를 다시 시작합니다. |
| 3 | 작업이 지원되지 않습니다. | 명령이 OS 및 에이전트 버전에 유효한지 확인합니다. |
| 4 | Arc 프록시 서비스가 실행되고 있지 않습니다. |
Hybrid Instance Metadata Service (himds) 서비스가 실행 중인지 확인합니다. |
| 5 | 파일 로거를 사용할 수 없습니다. | 디스크 공간 및 로그 디렉터리에 대한 사용 권한을 확인합니다. |
| 6 | 초기화에 실패했습니다. | 필수 구성 요소(네트워크, 권한)를 확인합니다. 문제를 해결한 후 다시 실행 azcmagent connect 합니다. |
| 11 | 사용자가 중단한 작업(Ctrl+C). | 중단 없이 명령을 다시 실행합니다. |
| 12 | 잘못된 액세스 토큰이 제공되었습니다. |
az login를 사용하여 Azure 자격 증명을 새로 고치거나 유효한 토큰을 제공하세요. |
| 18 | 관리 권한이 필요합니다. | 관리자 권한(sudo 또는 관리자 권한 명령 프롬프트)을 사용하여 명령을 실행합니다. |
| 19 | 구성 파일을 찾을 수 없습니다. | 를 사용하여 azcmagent config구성 파일 경로를 확인하거나 다시 생성합니다. |
| 20 | 알 수 없는 지역이 지정되었습니다. | 지역 맞춤법을 검사하고 지역이 지원되는지 확인합니다. |
| 23 | 잘못된 인수가 제공되었습니다. | 를 사용하여 azcmagent --help명령 구문을 검토합니다. |
| 26 | 네트워크 오류가 발생했습니다. | Azure 엔드포인트에 대한 연결의 유효성을 검사합니다. 방화벽 및 프록시 설정을 확인합니다. |
| 27 | 구성 충돌이 감지되었습니다. | 충돌하는 설정을 /etc/azcmagent/config.json 제거하거나 %ProgramData%\AzureConnectedMachineAgent\Config\localconfig.json 다시 시도합니다. |
| 28 | TPM 디바이스를 열지 못했습니다. | TPM(신뢰할 수 있는 플랫폼 모듈)이 활성화되고 액세스할 수 있는지 확인한 다음 다시 시도합니다. |
| 41 | 액세스 토큰을 가져오지 못했습니다. | 성공했는지 확인하고 az login 해당하는 경우 MSI를 사용하도록 설정합니다. |
| 42 | Azure 리소스를 만들지 못했습니다. | 구독 권한 및 리소스 할당량을 확인합니다. |
| 43 | Azure 리소스를 삭제하지 못했습니다. | 리소스가 있고 삭제 권한이 있는지 확인합니다. |
| 44 | 리소스가 이미 있습니다. | 매개 변수에 다른 --resource-name 이름을 지정하거나 기존 Azure Arc 사용 가능한 서버 리소스를 삭제하고 다시 실행azcmagent connect합니다. |
| 45 | 다시 연결 공개 키를 업데이트하지 못했습니다. | 네트워크 연결 및 에이전트 로그를 확인한 후 다시 시도합니다. |
| 61 | 에이전트 통신 오류입니다. | himds 서비스를 다시 시작합니다. |
| 62 | 컴퓨터를 Azure에 연결하지 못했습니다. | 네트워크 연결 및 구독 권한을 확인합니다. |
| 63 | Azure에서 컴퓨터 연결을 끊지 못했습니다. | 컴퓨터가 온라인 상태이고 에이전트가 정상인지 확인한 후 다시 시도합니다. |
| 64 | HIMDS 서버와의 통신을 가져올 수 없습니다. | 서비스를 다시 himds 시작하고 로그를 확인합니다. |
| 65 | 에이전트 메타데이터를 가져올 수 없습니다. | 에이전트 로그를 확인하고 다시 시도합니다. |
| 66 | 에이전트 상태를 가져올 수 없습니다. | 에이전트를 다시 시작하고 연결을 확인합니다. |
| 67 | 컴퓨터가 이미 연결되어 있습니다. | 실행 azcmagent disconnect 하여 현재 연결을 제거한 다음 다시 실행 azcmagent connect합니다. |
| 68 | 구독 ID를 가져올 수 없습니다. | Azure 자격 증명의 유효성을 검사하고 다시 시도합니다. |
| 69 | 로컬 구성을 업데이트하는 동안 오류가 발생했습니다. | 파일 사용 권한을 확인하고 다시 시도합니다. |
| 70 | 로컬 구성을 가져올 수 없습니다. | 구성 파일 무결성을 확인하고 다시 시도합니다. |
| 72 | 확장 도구를 실행하는 동안 오류가 발생했습니다. | 확장 로그를 확인하고 다시 시도합니다. |
| 73 | 파트너 구성을 가져올 수 없습니다. | 파트너 통합 설정의 유효성을 검사합니다. |
| 74 | 확장을 추가하는 동안 오류가 발생했습니다. | 확장 패키지가 유효한지 확인하고 다시 시도합니다. |
| 75 | 클라우드 구성을 가져올 수 없습니다. | Azure 엔드포인트에 대한 연결을 확인합니다. |
| 76 | TPM 기반 인증을 사용하여 컴퓨터를 Azure 연결하지 못했습니다. | TPM이 활성화되고 액세스할 수 있는지 확인한 다음 다시 시도합니다. |
| 81 | HIS에서 MSI 인증서를 가져오는 데 실패했습니다. | HIS 서비스가 실행 중인지 확인하고 다시 시도합니다. |
| 82 | TPM을 사용하여 HIS에서 MSI 인증서를 가져오는 데 실패했습니다. | HIS 서비스가 실행 중이고 TPM에 액세스할 수 있는지 확인하고 다시 시도합니다. |
| 83 | Arc 영구 자격 증명을 서비스에 등록하지 못했습니다. | 네트워크 연결을 확인하고 다시 시도합니다. |
| 101 | 명령 실행 오류입니다. | 명령 구문의 유효성을 검사하고 자세한 내용은 로그를 확인합니다. |
| 102 | 리소스 이름을 생성할 수 없습니다. | 호스트 이름이 Azure 명명 요구 사항을 충족하는지 확인합니다. |
| 103 | RSA 키를 처리하지 못했습니다. | Microsoft 지원팀에 도움을 요청하십시오. |
| 104 | 프라이빗 키를 검색하지 못했습니다. | 키 스토리지의 유효성을 검사하고 다시 시도합니다. |
| 105 | 서명된 메시지를 받지 못했습니다. | 연결을 확인하고 다시 시도합니다. |
| 106 | 매개 변수 파일을 저장하지 못했습니다. | 디스크 공간 및 사용 권한을 확인합니다. |
| 107 | 인증서를 검색하지 못했습니다. | 인증서 저장소의 유효성을 검사하고 다시 시도합니다. |
| 108 | TPM 키를 처리하지 못했습니다. | TPM이 활성화되고 액세스할 수 있는지 확인한 다음 다시 시도합니다. |
에이전트 자세한 정보 로그
이 문서의 뒷부분에 설명된 문제 해결 단계를 수행하려면 자세한 정보 표시 로그가 필요합니다. 이 로그는 자세한 정보(-v) 인수를 사용하는 경우 azcmagent tool 명령의 출력이 포함됩니다. 로그 파일은 Windows의 경우 %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log, Linux의 경우 /var/opt/azcmagent/log/azcmagent.log에 기록됩니다.
윈도우즈
다음 명령은 대화형 설치를 수행할 때 Windows 연결된 컴퓨터 에이전트를 사용하여 자세한 정보 로깅을 사용하도록 설정하는 예제입니다.
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose
다음 명령은 서비스 주체를 사용하여 대규모로 설치를 수행할 때 Windows용 Connected Machine 에이전트에서 상세 로깅을 사용하도록 설정하는 예제입니다.
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
--service-principal-id "{serviceprincipalAppID}" `
--service-principal-secret "{serviceprincipalPassword}" `
--resource-group "{ResourceGroupName}" `
--tenant-id "{tenantID}" `
--location "{resourceLocation}" `
--subscription-id "{subscriptionID}"
--verbose
Linux
다음 명령은 대화형 설치를 수행할 때 Linux용 Connected Machine 에이전트를 사용하여 자세한 정보 로깅을 사용하도록 설정하는 예제입니다.
참고
azcmagent를 실행하려면 Linux 머신에 대한 루트 액세스 권한이 있어야 합니다.
azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose
다음 명령은 서비스 주체를 사용하여 대규모 설치를 수행할 때 Linux용 Connected Machine 에이전트를 사용하여 자세한 정보 로깅을 사용하도록 설정하는 예제입니다.
azcmagent connect \
--service-principal-id "{serviceprincipalAppID}" \
--service-principal-secret "{serviceprincipalPassword}" \
--resource-group "{ResourceGroupName}" \
--tenant-id "{tenantID}" \
--location "{resourceLocation}" \
--subscription-id "{subscriptionID}"
--verbose
에이전트의 서비스 연결 문제
다음 표에서는 문제를 해결하고 해결하는 방법에 대한 다양한 오류 및 제안을 나열합니다.
| 오류 | 가능한 원인: | 솔루션 |
|---|---|---|
권한 부여 토큰 디바이스 흐름을 가져오지 못했습니다.Error occurred while sending request for Device Authorization Code: Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/devicecode?api-version=1.0: dial tcp 40.126.9.7:443: connect: network is unreachable. |
login.windows.net 엔드포인트에 연결할 수 없습니다. |
실행 azcmagent check 하여 방화벽이 Microsoft Entra ID에 대한 액세스를 차단하는지 확인합니다. |
권한 부여 토큰 디바이스 흐름을 가져오지 못했습니다.Error occurred while sending request for Device Authorization Code: Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/devicecode?api-version=1.0: dial tcp 40.126.9.7:443: connect: network is Forbidden; |
프록시 또는 방화벽에서 login.windows.net 엔드포인트에 대한 액세스를 차단하고 있습니다. |
실행 azcmagent check 하여 방화벽이 Microsoft Entra ID에 대한 액세스를 차단하는지 확인합니다. |
SPN에서 권한 부여 토큰을 획득하지 못했습니다.Failed to execute the refresh request. Error = 'Post https://login.windows.net/fb84ce97-b875-4d12-b031-ef5e7edf9c8e/oauth2/token?api-version=1.0: Forbidden' |
프록시 또는 방화벽에서 login.windows.net 엔드포인트에 대한 액세스를 차단하고 있습니다. |
실행 azcmagent check 하여 방화벽이 Microsoft Entra ID에 대한 액세스를 차단하는지 확인합니다. |
SPN에서 권한 부여 토큰을 획득하지 못했습니다.Invalid client secret is provided |
서비스 주체 암호가 잘못되었거나 유효하지 않습니다. | 서비스 주체 비밀을 확인합니다. |
SPN에서 권한 부여 토큰을 획득하지 못했습니다.Application with identifier 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' wasn't found in the directory 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. This can happen if the application has not been installed by the administrator of the tenant or consented to by any user in the tenant |
서비스 주체 및/또는 테넌트 ID가 잘못되었습니다. | 서비스 주체 및/또는 테넌트 ID를 확인합니다. |
ARM 리소스 응답 가져오기:The client 'username@domain.com' with object id 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' does not have authorization to perform action 'Microsoft.HybridCompute/machines/read' over scope '/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/MSJC01' or the scope is invalid. If access was recently granted, please refresh your credentials."}}" Status Code=403 |
자격 증명 및/또는 사용 권한이 잘못되었습니다. | 사용자 또는 서비스 주체가 Azure Connected Machine 온보딩 역할의 멤버인지 확인합니다. |
AzcmagentConnect ARM 리소스에 실패했습니다.The subscription isn't registered to use namespace 'Microsoft.HybridCompute' |
Azure 리소스 공급자가 등록되어 있지 않습니다. | 리소스 공급자를 등록합니다. |
AzcmagentConnect ARM 리소스에 실패했습니다.Get https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/MSJC01?api-version=2019-03-18-preview: Forbidden |
프록시 서버 또는 방화벽에서 management.azure.com 엔드포인트에 대한 액세스를 차단하고 있습니다. |
실행 azcmagent check 하여 방화벽이 Azure Resource Manager에 대한 액세스를 차단하는지 확인합니다. |
다음 단계
여기에 문제가 표시되지 않거나 문제를 해결할 수 없는 경우 다음 채널 중 하나를 통해 지원을 받으세요.
- Microsoft Q&A를 통해 Azure 전문가의 답변을 받습니다.
- 지원을 받으려면 지원 요청을 엽니다. 자세한 내용은 Azure 지원 요청 만들기를 참조하세요.