이 단계별 문제 해결 가이드는 Microsoft Dev Box 연결 문제를 찾고 해결하는 데 도움이 될 수 있습니다. 이러한 문제에는 연결 불가능, 로그인 문제, 빈번한 연결 끊김 또는 긴 대기 시간이 포함될 수 있습니다.
필수 구성 요소
| 카테고리 | 요구 사항 |
|---|---|
| Tools | 개발 상자를 만들거나 액세스하려면 조직에서 하나 이상의 프로젝트와 하나의 개발 상자 풀을 사용하여 Microsoft Dev Box를 설정해야 합니다. 조직에 대해 Microsoft Dev Box를 설정하려면 빠른 시작: Microsoft Dev Box 구성을 참조하세요. |
| Tools | Windows 앱을 사용하여 개발 상자에 연결하려면 클라이언트 디바이스 에 Windows 앱을 설치 합니다. |
| Permissions | 개발 상자를 만들거나 액세스하려면 사용 가능한 개발 상자 풀이 있는 프로젝트에서 Dev Box 사용자 권한이 필요합니다. 프로젝트에 대한 권한이 없는 경우 관리자에게 문의하세요. |
잠재적인 빠른 해결 방법
개발 상자 문제를 자동으로 식별하고 해결하려면 문제 해결 및 복구를 실행해 보세요. 개발자 포털에 로그인하고 개발 상자 타일의 추가 작업 메뉴에서 문제 해결 및 복구를 선택합니다. 자세한 내용은 문제 해결 및 복구 도구를 사용하여 연결 문제 해결을 참조하세요.
문제 해결 검사 목록
- 클라이언트 디바이스에 활성 인터넷 연결이 있는지 확인합니다.
- 클라이언트 디바이스 및 개발 상자에 최신 운영 체제 및 보안 업데이트가 설치되어 있는지 확인합니다.
- 클라이언트 디바이스에 최신 Windows 앱이 설치되어 있는지 확인합니다.
- 클라이언트 또는 개발 상자에서 원격 연결을 방해할 수 있는 부적절한 네트워크 구성 또는 인터넷 프록시 설정을 확인합니다.
- 개발 상자 상태가 실행 중인지 확인합니다. 상태가 중지되거나최대 절전 모드인 경우 개발자 포털의 개발 상자 타일에 있는 기타 작업 메뉴에서 시작 또는 다시 시작을 선택합니다.
- Windows 업데이트를 확인합니다. Windows가 업데이트되는 동안에는 최대 30분 동안 개발 상자에 연결할 수 없습니다.
- 개발 상자에 액세스할 수 있는 경우 세션 중에 위쪽 연결 표시줄에서 아이콘을 선택하여 보안 및 연결 정보를 검토합니다.
- 개발 상자에서 알려진 원격 데스크톱 연결 문제 해결에서 알려진 연결 문제를 검토합니다.
원격 연결 문제
개발 상자에 대한 Windows 앱 연결이 중단되거나 실패하는 경우 다음 단계를 시도하여 연결합니다.
- 개발자 포털에 로그인하고 개발 상자 타일의 추가 작업 메뉴에서 다시 시작을 선택하여 개발 상자를 다시 시작합니다.
- 다시 시작되면 Windows 앱을 통해 연결을 선택하여 다시 연결해 보세요.
- Windows 앱을 통해 연결 옆에 있는 캐리트를 선택한 다음 브라우저에서 열기를 선택하여 브라우저를 통해 연결을 시도합니다.
- 로그아웃한 다음 개발자 포털로 다시 로그인하고 다시 연결을 시도합니다.
- 작업 관리자를 열고 실행 중인 msrdc.exe 또는 msrdcw.exe 프로세스를 종료합니다. 그리고 다시 연결해 봅니다.
로그인 및 인증 문제
올바른 자격 증명을 사용했음에도 불구하고 로그인 또는 인증 문제가 있는 경우 다음 단계를 시도합니다.
- 가능한 경우 클라이언트 디바이스 및 개발 상자에서 Microsoft Entra ID 조인 상태를 확인하는 데 사용합니다
dsregcmd.exe /status. 지원 팀에서 오류를 해결한 후 컴퓨터를 다시 시작합니다. - 한동안 개발 상자에 액세스하지 않으면 Microsoft Entra ID가 비활성으로 인해 계정을 제거할 수 있습니다. 다시 액세스하려면 지원 팀에 문의하세요.
-
dsregcmd.exe /refreshprt세션의 PRT(기본 새로 고침 토큰)를 새로 고치는 데 사용해 보세요. 그런 다음 로그아웃하고 다시 로그인합니다. - 관리자 권한이 있는 경우,
dsregcmd.exe /forcerecovery를 사용하여 다시 인증 및 재등록을 시도하거나,dsregcmd.exe /leave과dsregcmd.exe /join를 사용하여 Microsoft Entra ID에서 나갔다가 다시 가입하는 것을 시도해 보십시오. 자세한 내용은 dsregcmd 명령을 사용하여 디바이스 문제 해결을 참조하세요. - Azure Portal에서 관리자 권한이 있는 경우 풀을 삭제하고 다시 만들어서 개발 상자 풀에서 개발 상자를 구독 취소했다가 다시 구독해야 할 수도 있습니다.
높은 CPU 로드 중 연결 문제
개발 상자에서 높은 CPU 로드 중에 자주 연결이 끊어지면 레지스트리 설정을 적용하여 원격 연결 세션에 더 많은 GPU 우선 순위를 부여할 수 있습니다.
개발 상자에 최신 Windows 11 빌드가 있는지 확인합니다.
개발 상자에서 레지스트리 편집기를 열고 다음 레지스트리 설정을 추가합니다.
키: HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations
설정: SetGpuRealtimePriority
값: DWORD 2또는 관리자 권한 셸에서 이 명령을 실행하여 SetGpuRealtimePriority 레지스트리 설정 및 값을 추가하고 설정할 수 있습니다.
reg add "HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations" /v SetGpuRealtimePriority /d 2 /t REG_DWORD개발 상자를 다시 시작합니다.
CPU 사용량이 적은 동안의 연결 문제
개발 상자에서 CPU 사용량이 적더라도 연결이 자주 끊어지면 원격 데스크톱 연결을 전환하여 UDP(사용자 데이터그램 프로토콜) 대신 TCP(Transmission Control Protocol)를 사용할 수 있습니다. 연결에서 TCP만 사용하도록 하려면 클라이언트 디바이스와 개발 상자 모두에서 설정을 변경합니다.
클라이언트 설정
UDP 연결을 시도하지 않도록 클라이언트에 명시적으로 지시합니다.
- 로컬 그룹 정책 편집기를
gpedit.msc엽니다. - 컴퓨터 구성>관리 템플릿>Windows 구성 요소>원격 데스크톱 서비스>원격 데스크톱 연결 클라이언트로 이동합니다.
- 정책 설정을 클라이언트에서 UDP 사용 안 함으로 설정한 다음 확인을 선택합니다.
또는 레지스트리를 편집하여 다음 fClientDisableUDP 설정을 추가할 수 있습니다 .
키: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client
설정: fClientDisableUDP
값: DWORD 1
관리자 권한 셸에서 다음 명령을 실행하여 fClientDisableUDP 레지스트리 설정 및 값을 적용할 수도 있습니다.
reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client" /v fClientDisableUDP /d 1 /t REG_DWORD
호스트 설정
그룹 정책 편집기를 사용하여 TCP만 사용하도록 개발 상자에서 원격 데스크톱 전송 프로토콜을 설정합니다.
- 개발 상자에서 로컬 그룹 정책 편집기를
gpedit.msc엽니다. - 컴퓨터 구성>관리 템플릿>Windows 구성 요소>원격 데스크톱 서비스>원격 데스크톱 세션 호스트>연결로 이동합니다.
- 정책 설정을 RDP 전송 프로토콜 선택으로 사용하도록 설정합니다.
- 전송 유형 선택에서 TCP만 사용을선택한 다음 확인을 선택합니다.
이러한 변경을 수행한 후, 두 컴퓨터에서 관리자 권한 셸에서 gpupdate /force를 실행하고 다시 시작합니다.
지원 받기
이전 단계에서 문제가 해결되지 않으면 관리 팀에 문의하거나, 더 많은 지원 리소스에 액세스하거나, 지원 요청을 제출할 수 있습니다.
개발자 포털의 개발 상자 타일에 있는 추가 작업 메뉴에서 지원을 선택하여 개발 상자 지원 창을 엽니다. 창에서 다음을 수행할 수 있습니다.
- 개발 상자 문제 해결 링크를 선택하여 개발 상자 문제를 해결합니다. 자세한 내용은 문제 해결 및 복구 도구를 사용하여 연결 문제 해결을 참조하세요.
- 지원 세부 정보 복사를 선택하여 개발자 상자 및 관리자 또는 지원 팀에 제공할 수 있는 문제 ID에 대한 세부 정보를 복사합니다.
- Azure 도움말 + 지원 링크를 선택하여 개발 상자 프로젝트에 대한 Azure Portal 도움말 + 지원 페이지를 엽니다. 도움말 + 지원 페이지에서 작업에서 문제 해결을 선택하여 문제 해결 단계를 안내하거나 지원 요청 만들기를 선택하여 지원 요청을 만드는 방법을 안내할 수 있습니다.
지원 요청을 제출하는 경우 다음을 포함합니다.
- 문제에 대한 자세한 설명입니다.
- 문제가 발생한 시간입니다.
- 영향을 받은 사용자입니다.
- 사용 가능한 경우 개발 상자 및 원격 세션에 대한 기타 정보(예: 활동 ID).
개발 상자 연결 및 보안 정보 가져오기
개발 상자에 액세스할 수 있는 경우 세션 중에 위쪽 연결 표시줄에서 해당 아이콘을 선택하여 보안 및 연결 정보를 얻을 수 있습니다.
타임스탬프 및 활동 ID와 같은 연결 세부 정보를 보려면 연결 대화 상자에서 세부 정보 보기를 선택합니다. Ctrl+C를 눌러 연결 세부 정보를 복사하고 확인을 선택하여 대화 상자를 닫습니다.