Портал устройств для компьютеров с WindowsDevice Portal for Windows Desktop

Портал устройств Windows — это средство отладки, с помощью которого можно просматривать диагностические сведения и взаимодействовать с ПК по протоколу HTTP из веб-браузера.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.

Используя портал устройств, можно выполнять следующие действия: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
  • Просматривать графики в режиме реального времени со сведениями об использовании ЦП, памяти, устройств ввода-вывода и GPUView live graphs of CPU, memory, I/O, network, and GPU usage
  • Собирать дампы процессовCollect process dumps
  • Собирать трассировки событий WindowsCollect ETW traces
  • Работать с изолированным хранилищем неопубликованных приложенийManipulate the isolated storage of sideloaded apps

Настройка портала устройств на компьютере под управлением WindowsSet 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. Не используйте учетную запись Майкрософт или другие учетные данные 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.

  • Локальный узел: 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.

Подключение портала устройств на компьютере с WindowsDevice 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 Reality
  • Отладчик потоковой установкиStreaming Install Debugger
  • РасположениеLocation
  • Рабочая зонаScratch

Использование портала устройств в Windows для настольных ПК для тестирования и отладки приложений MSIXUsing Device Portal for Windows Desktop to test and debug MSIX apps

Дополнительные параметры портала устройствMore Device Portal options

Настройка на основе реестра для портала устройствRegistry-based configuration for 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\ServiceUnder 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. Содержит номер порта, который портал устройств будет прослушивать на предмет активных подключений HTTP.Contains the port number that Device Portal will listen for HTTP connections on.
    • HttpsPort: необходимый параметр DWORD.HttpsPort: A required DWORD. Содержит номер порта, который портал устройств будет прослушивать на предмет активных подключений HTTPS.Contains the port number that Device Portal will listen for HTTPS connections on.

В том же пути раздела реестра можно также отключить требование к проведению проверки подлинности: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–z, A–Z, 0–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
    • В результате это происходит сброс кэша SSL-сертификата, используемого подключениями по протоколу HTTPS.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 Magazine.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. Перейдите в раздел Параметры > Update & Security (Обновление и безопасность) > Программа предварительной оценки Windows и убедитесь, что в разделе Windows Insider account (Учетная запись Программы предварительной оценки Windows) указаны правильные сведения об учетной записи.Navigate to Settings > Update & Security > Windows Insider Program and confirm that the Windows Insider account section has your correct account info. Если вы не видите этот раздел, щелкните Link a Windows Insider account (Связать учетную запись Программы предварительной оценки Windows), добавьте учетную запись электронной почты и убедитесь, что она отображается под заголовком Windows Insider account (Учетная запись Программы предварительной оценки Windows) (возможно, потребуется выбрать Link a Windows Insider account (Связать учетную запись Программы предварительной оценки 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. В разделе What kind of content would you like to receive? (Какого типа содержимое вы хотите получать?) щелкните Active development of Windows (Активная разработка Windows).Under What kind of content would you like to receive?, make sure Active development of Windows is selected.

  3. В разделе What pace do you want to get new builds? (Как часто вы хотите получать новые сборки?) щелкните Windows Insider Fast (Предварительная оценка Windows — ранний доступ).Under What pace do you want to get new builds?, make sure Windows Insider Fast is selected.

  4. Теперь вы сможете установить компоненты по запросу.You should now be able to install the FoDs. Если вы подтвердили, что вы участник программы предварительной оценки Windows и по-прежнему не можете установить компоненты по запросу, оставьте отзыв и приложите файлы журнала в каталог 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 FAILED 1060: The specified service does not exist as an installed service (Указанная служба не установлена)[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 cannot start download because the system is on metered network (CBS_E_METERED_NETWORK) (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