Windows 데스크톱의 장치 포털Device Portal for Windows Desktop

Windows 장치 포털은 웹 브라우저에서 HTTP를 통해 진단 정보를 살펴보고 데스크톱 PC와 상호 작용할 수 있는 디버깅 도구입니다.Windows Device Portal is a debugging tool that lets you view diagnostic information and interact with your desktop PC over HTTP from a web browser. 다른 디바이스를 디버그하려면 Windows 장치 포털 개요를 참조하세요.To debug other devices, see Windows Device Portal overview.

Device Portal을 사용하여 다음 작업을 수행할 수 있습니다.You can use Device Portal to do the following:

  • 실행 중인 프로세스 목록 확인 및 조작See and manipulate a list of running processes
  • 앱 설치, 삭제, 시작 및 종료Install, delete, launch, and terminate apps
  • Wi-Fi 프로필 변경, 신호 강도 보기 및 ipconfig 확인Change Wi-Fi profiles, view signal strength, and see ipconfig
  • CPU의 라이브 그래프, 메모리, I/O 네트워크 및 GPU 사용 보기View live graphs of CPU, memory, I/O, network, and GPU usage
  • 프로세스 덤프 수집Collect process dumps
  • ETW 추적 수집Collect ETW traces
  • 테스트용으로 로드된 앱의 격리된 스토리지 조작Manipulate the isolated storage of sideloaded apps

Window 데스크톱에서 장치 포털 설정Set up Device Portal on Windows Desktop

개발자 모드 켜기Turn on developer mode

Windows 10 1607 버전부터 데스크톱의 새로운 기능 중 일부는 개발자 모드를 켜야만 사용할 수 있습니다.Starting in Windows 10, version 1607, some of the newer features for desktop are only available when developer mode is enabled. 개발자 모드를 켜는 방법에 대한 내용은 디바이스를 개발에 사용하도록 설정을 참조하세요.For information about how to enable developer mode, see Enable your device for development.

중요

경우에 따라 네트워크 또는 호환성 문제로 인해 디바이스에 개발자 모드가 제대로 설치되지 않을 수 있습니다.Sometimes, due to network or compatibility issues, developer mode won't install correctly on your device. 이러한 문제 해결에 대한 도움말은 디바이스를 개발에 사용하도록 설정의 관련 섹션을 참조하세요.See the relevant section of Enable your device for development for help troubleshooting these issues.

장치 포털 켜기Turn on Device Portal

설정개발자 섹션에서 장치 포털을 사용하도록 설정할 수 있습니다.You can enable Device Portal in the For developers section of Settings. 장치 포털을 사용하도록 설정하는 경우 해당하는 사용자 이름과 암호도 만들어야 합니다.When you enable it, you must also create a corresponding username and password. Microsoft 계정 또는 기타 Windows 자격 증명은 사용하지 마세요.Do not use your Microsoft account or other Windows credentials.

[설정] 앱의 장치 포털 섹션

장치 포털이 사용하도록 설정되면 섹션 아래쪽에 웹 링크가 표시됩니다.Once Device Portal is enabled, you will see web links at the bottom of the section. 나열된 URL의 끝에 첨부되어 있는 포트 번호를 적어 둡니다. 이 포트 번호는 장치 포털을 사용하도록 설정할 때 무작위로 생성되지만, 데스크톱을 다시 부팅해도 동일하게 유지됩니다.Take note of the port number appended to the end of the listed URLs: this number is randomly generated when Device Portal is enabled but should remain consistent between reboots of the desktop.

이러한 링크를 사용하여 두 가지 방법으로(로컬 네트워크(VPN 포함)를 통해 또는 로컬 호스트를 통해) 장치 포털에 연결할 수 있습니다.These links offer two ways to connect to Device Portal: over the local network (including VPN) or through the local host. 연결되면 다음과 같이 표시됩니다.Once you connect, it should look something like this:

디바이스 포털

장치 포털 끄기Turn off Device Portal

설정개발자 섹션에서 장치 포털을 사용하지 않도록 설정할 수 있습니다.You can disable Device Portal in the For developers section of Settings.

장치 포털에 연결Connect to Device Portal

로컬 호스트를 통해 연결하려면 브라우저 창을 열고, 사용 중인 연결 유형에 대해 여기에 표시된 주소를 입력합니다.To connect through local host, open a browser window and enter the address shown here for the connection type you're using.

  • Localhost: http://127.0.0.1:<PORT> 또는 http://localhost:<PORT>Localhost: http://127.0.0.1:<PORT> or http://localhost:<PORT>
  • 로컬 네트워크: https://<IP address of the desktop>:<PORT>Local Network: https://<IP address of the desktop>:<PORT>

인증 및 보안 통신을 위해 HTTPS가 필요합니다.HTTPS is required for authentication and secure communication.

로컬 네트워크에 있는 모든 사용자를 신뢰하고, 디바이스에 개인 정보가 없고, 고유한 요구 사항이 있는 테스트 랩 같은 보호 환경에서 장치 포털을 사용하는 경우 인증 옵션을 사용하지 않도록 설정해도 됩니다.If you are using Device Portal in a protected environment, for example, in a test lab, in which you trust everyone on your local network, have no personal information on the device, and have unique requirements, you can disable the Authentication option. 이렇게 하면 암호화되지 않은 통신이 가능하며, 개발자 컴퓨터의 IP 주소를 갖고 있는 모든 사용자가 개발자 컴퓨터에 연결하여 제어할 수 있습니다.This enables unencrypted communication, and allows anyone with the IP address of your computer to connect to and control it.

Windows 데스크톱의 장치 포털 콘텐츠Device Portal content on Windows Desktop

Windows 데스크톱의 장치 포털에는 Windows 장치 포털 개요에 설명된 페이지 세트가 표시됩니다.Device Portal on Windows Desktop will display the set of pages described in Windows Device Portal overview.

  • 앱 관리자Apps manager
  • Xbox LiveXbox Live
  • 파일 탐색기File explorer
  • 실행 중인 프로세스Running Processes
  • 성능Performance
  • 디버그Debug
  • ETW(Windows용 이벤트 추적) 로깅ETW (Event Tracing for Windows) logging
  • 성능 추적Performance tracing
  • 디바이스 관리자Device manager
  • BluetoothBluetooth
  • 네트워킹Networking
  • 충돌 데이터Crash data
  • 기능Features
  • Mixed RealityMixed Reality
  • 스트리밍 설치 디버거Streaming Install Debugger
  • 위치Location
  • 스크래치Scratch

Windows 데스크톱의 장치 포털을 사용하여 MSIX 앱 테스트 및 디버그Using Device Portal for Windows Desktop to test and debug MSIX apps

기타 장치 포털 옵션More Device Portal options

장치 포털의 레지스트리 기반 구성Registry-based configuration for Device Portal

Device Portal용 포트 번호(예: 80 및 443)를 선택하려는 경우 다음 레지스트리 키를 설정할 수 있습니다.If you would like to select port numbers for Device Portal (such as 80 and 443), you can set the following regkeys:

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service 아래Under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
    • UseDynamicPorts: 필수 DWORD.UseDynamicPorts: A required DWORD. 선택한 포트 번호를 유지하려면 이 항목을 0으로 설정합니다.Set this to 0 in order to retain the port numbers you've chosen.
    • HttpPort: 필수 DWORD.HttpPort: A required DWORD. Device Portal이 HTTP 연결을 수신 대기하는 포트 번호를 포함합니다.Contains the port number that Device Portal will listen for HTTP connections on.
    • HttpsPort: 필수 DWORD.HttpsPort: A required DWORD. Device Portal이 HTTPS 연결을 수신 대기하는 포트 번호를 포함합니다.Contains the port number that Device Portal will listen for HTTPS connections on.

동일한 regkey 경로에서 다음과 같이 인증 요구 사항을 해제할 수 있습니다.Under the same regkey path, you can also turn off the authentication requirement:

  • UseDefaultAuthorizer - 사용하지 않으려면 0, 사용하려면 1로 설정합니다.UseDefaultAuthorizer - 0 for disabled, 1 for enabled.
    • 이는 각 연결과 HTTP에서 HTTPS로의 리디렉션에 대한 기본적인 인증 요구 사항을 모두 제어합니다.This controls both the basic auth requirement for each connection and the redirect from HTTP to HTTPS.

장치 포털의 명령줄 옵션Command line options for Device Portal

관리 명령 프롬프트에서 장치 포털의 여러 부분을 사용하도록 설정하고 구성할 수 있습니다.From an administrative command prompt, you can enable and configure parts of Device Portal. 빌드에서 지원되는 최신 명령 세트를 보려면 webmanagement /?를 실행합니다.To see the latest set of commands supported on your build, you can run webmanagement /?

  • sc start webmanagement 또는 sc stop webmanagementsc start webmanagement or sc stop webmanagement
    • 서비스를 켜거나 끕니다.Turn the service on or off. 이 경우에도 개발자 모드를 사용하도록 설정해야 합니다.This still requires developer mode to be enabled.
  • -Credentials <username> <password>
    • 장치 포털의 사용자 이름 및 암호를 설정합니다.Set a username and password for Device Portal. 사용자 이름은 기본 인증 표준을 준수해야 하므로 콜론(:)을 포함할 수 없고, 브라우저가 표준 방식으로는 전체 문자 세트를 구문 분석할 수 없기 때문에 표준 ASCII 문자(예: [a-zA-Z0-9])에서 구성해야 합니다.The username must conform to Basic Auth standards, so cannot contain a colon (:) and should be built out of standard ASCII characters for example, [a-zA-Z0-9] as browsers do not parse the full character set in a standard way.
  • -DeleteSSL
    • 이는 HTTPS 연결에 사용되는 SSL 인증서 캐시를 다시 설정합니다.This resets the SSL certificate cache used for HTTPS connections. (예상한 인증서 경고가 아닌) 무시할 수 없는 TLS 연결 오류가 발생하는 경우 이 옵션으로 문제를 해결할 수도 있습니다.If you encounter TLS connection errors that cannot be bypassed (as opposed to the expected certificate warning), this option may fix the problem for you.
  • -SetCert <pfxPath> <pfxPassword>
  • -Debug <various options for authentication, port selection, and tracing level>
    • 특정 구성과 표시되는 디버그 메시지를 사용하는 독립 실행형 장치 포털 버전을 실행합니다.Run a standalone version of Device Portal with a specific configuration and visible debug messages. 패키지된 플러그인을 빌드하는 데 가장 유용합니다.This is most useful for building a packaged plugin.
    • 패키지된 플러그인을 테스트하기 위해 이를 실행하는 방법에 대한 자세한 내용은 MSDN 잡지 문서를 참조하세요.See the MSDN Magazine article for details on how to run this as System to fully test your packaged plugin.

문제 해결Troubleshooting

다음은 장치 포털을 설정할 때 발생할 수 있는 일반적인 오류입니다.Below are some common errors that you may encounter when setting up Device Portal.

WindowsUpdateSearch에서 잘못된 업데이트 수를 반환(0x800f0950 CBS_E_INVALID_WINDOWS_UPDATE_COUNT)WindowsUpdateSearch returns invalid number of updates (0x800f0950 CBS_E_INVALID_WINDOWS_UPDATE_COUNT)

Windows 10 시험판 빌드에 개발자 패키지를 설치하려고 할 때 이 오류가 발생할 수 있습니다.You may get this error when trying to install the developer packages on a pre-release build of Windows 10. 이러한 FoD(주문형 기능) 패키지는 Windows 업데이트에 호스팅되며, 시험판 빌드에서 이 패키지를 다운로드하려면 플라이팅을 옵트인해야 합니다.These Feature-on-Demand (FoD) packages are hosted on Windows Update, and downloading them on pre-release builds requires that you opt into flighting. 설치를 올바른 빌드 및 링 조합에 대한 플라이팅에 옵트인하지 않으면 페이로드가 다운로드되지 않습니다.If your installation is not opted into flighting for the right build and ring combination, the payload will not be downloadable. 다음 사항을 철저하게 확인하세요.Double-check the following:

  1. 설정 > 업데이트 및 보안 > Windows 참가자 프로그램으로 이동하여 Windows 참가자 계정 섹션의 계정 정보가 올바른지 확인합니다.Navigate to Settings > Update & Security > Windows Insider Program and confirm that the Windows Insider account section has your correct account info. 이 섹션이 보이지 않으면 Windows 참가자 계정 연결을 선택하고, 이메일 계정을 추가하고, 해당 계정이 Windows 참가자 계정 제목 아래에 표시되는지 확인합니다(새로 추가된 계정을 실제로 연결하려면 Windows 참가자 계정 연결을 한 번 더 선택해야 할 수도 있음).If you don't see that section, select Link a Windows Insider account, add your email account, and confirm that it shows up under the Windows Insider account heading (you may need to select Link a Windows Insider account a second time to actually link a newly added account).

  2. 어떤 유형의 콘텐츠를 받으시겠습니까? 아래에서 Active development of Windows(진행 중인 Windows 개발) 를 선택합니다.Under What kind of content would you like to receive?, make sure Active development of Windows is selected.

  3. 어떤 속도로 새 빌드를 받으시겠습니까? 아래에서 Windows 초기 참가자를 선택합니다.Under What pace do you want to get new builds?, make sure Windows Insider Fast is selected.

  4. 이제 FoD를 설치할 수 있습니다.You should now be able to install the FoDs. Windows 초기 참가자에 이름이 있는 것을 확인했지만 여전히 FoD를 설치할 수 없는 경우에는 피드백을 제출하고 C:\Windows\Logs\CBS의 로그 파일을 첨부해 주세요.If you've confirmed that you're on Windows Insider Fast and still cannot install the FoDs, please provide feedback and attach the log files under C:\Windows\Logs\CBS.

[SC] StartService: OpenService 실패 1060: 설치된 서비스 중에는 지정된 서비스가 없습니다.[SC] StartService: OpenService FAILED 1060: The specified service does not exist as an installed service

개발자 패키지가 설치되지 않은 경우 이 오류가 발생할 수 있습니다.You may get this error if the developer packages aren't installed. 개발자 패키지가 없으면 웹 관리 서비스가 없습니다.Without the developer packages, there is no web management service. 개발자 패키지를 다시 설치해 보세요.Try installing the developer packages again.

시스템이 요금제 네트워크에 있으므로 CBS에서 다운로드를 시작할 수 없음(CBS_E_METERED_NETWORK)CBS cannot start download because the system is on metered network (CBS_E_METERED_NETWORK)

요금제 인터넷 연결을 사용하는 경우 이 오류가 발생할 수 있습니다.You may get this error if you're on a metered internet connection. 요금제 연결에서는 개발자 패키지를 다운로드할 수 없습니다.You won't be able to download the developer packages on a metered connection.

참조See also