适用于桌面设备的 Windows 设备门户

  • 项目

Windows 设备门户 (WDP) 是一个设备管理和调试工具，使用它，可以从 web 浏览器通过 HTTP 配置和管理设备设置并查看诊断信息。 有关其他设备上的 WDP 详细信息，请参阅 Windows 设备门户概述。

可以使用 WDP 进行以下操作：

  • 管理设备设置（类似于“Windows 设置”应用）
  • 查看并操作正在运行的进程的列表
  • 安装、删除、启动和终止应用
  • 更改 WLAN 配置文件、查看信号强度并查看 ipconfig 详细信息
  • 查看 CPU、内存、I/O、网络和 GPU 使用情况的实时图
  • 收集进程转储
  • 收集 ETW 跟踪
  • 操作旁加载应用的独立存储

在桌面设备上设置 Windows 设备门户

打开开发人员模式

从 Windows 10 版本 1607 开始，适用于桌面的一些较新功能仅在启用开发人员模式时可用。 有关如何启用开发人员模式的信息，请参阅启用设备进行开发。

重要

有时，由于网络或兼容性问题，开发人员模式无法在你的设备上正确安装。 有关解决这些问题的帮助，请参阅启用设备进行开发的相关部分。

打开 Windows 设备门户

可在“设置”的“适用于开发人员”部分启用 WDP（“设置”->“隐私和安全性”->“适用于开发人员”）。 当你启用它时，你还必须创建相应的用户名和密码。 不要使用你的 Microsoft 帐户或其他 Windows 凭据。

Windows Device Portal section of the Settings app

启用 WDP 后，你将在该部分的底部看到 Web 链接。 记下追加到所列 URL 末尾的端口号：此端口号在启用 WDP 时随机生成，但应在桌面重启后保持一致。

这些链接提供了连接到 WDP 的两种方法：通过本地网络（包括 VPN）或通过本地主机。 连接后，你应该会看到类似下面的屏幕：

Windows Device Portal

关闭 Windows 设备门户

可以在“Windows 设置”的“面向开发人员”部分中禁用 WDP 。

连接到 Windows 设备门户

要通过本地主机进行连接，请打开浏览器窗口，然后输入此处显示的 URI 之一（根据你正在使用的连接类型）。

  • Localhost：http://127.0.0.1:<PORT> 或 http://localhost:<PORT>
  • 本地网络：https://<IP address of the desktop>:<PORT>

身份验证和安全通信要求使用 HTTPS。

如果在信任本地网络上的所有用户、设备上没有任何私人信息并且具有独特要求的受保护环境（例如测试实验室）中使用 WDP，你可以禁用“身份验证”选项。 这支持未加密的通信，并允许任何拥有你的计算机 IP 地址的用户连接到通信并控制它。

Windows 设备门户内容

WDP 提供了以下一组页面。

  • 应用管理器
  • Xbox Live
  • 文件资源管理器
  • 正在运行的进程
  • 性能
  • 调试
  • ETW（Windows 事件跟踪）日志记录
  • 性能跟踪
  • 设备管理器
  • Bluetooth
  • 网络
  • 崩溃数据
  • 功能
  • 混合现实
  • 流式安装调试程序
  • 位置
  • Scratch

使用 Windows 设备门户测试和调试 MSIX 应用

以下视频介绍了如何使用 Windows 设备门户远程测试和调试 MSIX 应用。

Windows 设备门户的更多选项

以下各部分详细介绍了其他 Windows 设备门户选项。

基于注册表的配置

如果你希望为 WDP 选择端口号（如 80 和 443），你可以设置以下 RegKey：

  • （位于 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service 下面）
    • UseDynamicPorts：一个必需的 DWORD。 将其设置为 0，以便保留你已选择的端口号。
    • HttpPort：一个必需的 DWORD。 包含 WDP 用于侦听 HTTP 连接的端口号。
    • HttpsPort：一个必需的 DWORD。 包含 WDP 用于侦听 HTTPS 连接的端口号。

在相同的 RegKey 路径下，你也可以关闭身份验证要求：

  • UseDefaultAuthorizer - 0 为禁用，1 为启用。
    • 这可控制每个连接的基本身份验证要求以及从 HTTP 到 HTTPS 的重定向。

Windows 设备门户的命令行选项

通过管理命令提示符，可以启用和配置 WDP 的部件。 要查看版本上支持的最新命令集，可以运行 webmanagement /?

  • sc start webmanagement 或 sc stop webmanagement
    • 打开或关闭该服务。 这仍需要启用开发人员模式。
  • -Credentials <username> <password>
    • 设置 WDP 的用户名和密码。 用户名必须符合基本身份验证标准，因此不得包含冒号 (:) 且应从标准 ASCII 字符（例如 [a-zA-Z0-9]）中构建，因为浏览器不会以标准方式解析全字符集。
  • -DeleteSSL
    • 这将重置用于 HTTPS 连接的 SSL 证书缓存。 如果你遇到无法避免的 TLS 连接错误（而不是预期的证书警告），此选项可为你解决该问题。
  • -SetCert <pfxPath> <pfxPassword>
  • -Debug <various options for authentication, port selection, and tracing level>
    • 运行独立版本的具有特定配置和可见调试消息的 WDP。 这对于生成打包的插件最为有用。
    • 有关如何作为系统运行此项以完全测试你的打包插件的详细信息，请参阅 MSDN 杂志文章。

疑难解答

下面介绍在设置 Windows 设备门户时可能会遇到的一些常见错误。

WindowsUpdateSearch 返回无效的更新数 (0x800f0950)

尝试在 Windows 的预发行版上安装开发人员包时，可能会收到此错误。 这些按需功能 (FoD) 包托管在 Windows 更新上，要在预发行版本上下载它们，则需要选择加入外部测试。 如果安装没有选择加入外部测试以查找正确的版本和环组合，则将无法下载有效负载。 仔细检查以下内容：

  1. 导航到“设置”“更新 > 安全性”>“Windows 预览体验计划”，并确认“Windows 预览体验成员帐户”部分中包含正确的帐户信息。 如果没有看到该部分，请选择“链接 Windows 预览体验成员帐户”，添加电子邮件帐户，并确认它显示在“Windows 预览体验成员帐户”标题下（可能需要再次选择“链接 Windows 预览体验成员帐户”以实际链接新添加的帐户）。

  2. 在“要接收哪种类型的内容?”下，确保选中“Windows 积极开发”。

  3. 在“要以什么进度来获取新版本?”下，确保选中“Windows 预览体验 - 快”。

  4. 现即可安装 FoDs。 如果确认使用的是 Windows 预览体验 - 快，但仍然无法安装 FoDs，请提供反馈并将日志文件附加在 C:\Windows\Logs\CBS 下。

[SC] StartService：OpenService FAILED 1060：指定的服务不作为已安装的服务存在

如果未安装开发人员包，则可能会收到此错误。 没有开发人员包，就没有 Web 管理服务。 尝试再次安装开发人员包。

CBS 无法开始下载，因为系统位于按流量计费的网络 (CBS_E_METERED_NETWORK)

如果使用的是按流量计费的 Internet 连接，则可能会收到此错误。 你将无法通过按流量计费的连接下载开发人员包。

请参阅