适用于桌面的 Windows 设备门户

Windows设备门户（WDP）是一种设备管理和调试工具，可用于配置和管理设备设置，并通过 Web 浏览器通过 HTTP 查看诊断信息。 有关其他设备上的 WDP 详细信息，请参阅Windows设备门户概述。

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

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

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

启用设备门户之前，需要开发人员模式。

注释

有关启用开发人员模式的说明，请参阅 开发人员的设置。

打开Windows设备门户

你可以在 “面向开发人员” 部分中启用 WDP，该部分位于 “设置”（设置 > 系统 > 高级）中。

启用 WDP 后，“设备门户”部分底部会显示 URI。 记下追加到列出的 URL 末尾的端口号：启用 WDP 时会随机生成此编号，但在桌面重新启动之间应保持一致。

这些链接提供两种方法来连接到 WDP：通过本地网络（包括 VPN）或通过本地主机。

关闭 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 提供以下一组页面。

• 应用管理器
• 文件资源管理器
• 正在运行的进程
• Performance
• Debug
• ETW（Windows 事件跟踪）日志记录
• 性能追踪
• 设备管理器
• 蓝牙
• 网络
• 崩溃数据
• Features
• 位置
• Scratch

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

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

更多Windows设备门户选项

以下部分提供有关其他Windows设备门户选项的详细信息。

基于注册表的配置

如果要为 WDP（如 80 和 443）选择端口号，可以设置以下正则键：

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

在同一个正则密钥路径下，还可以关闭身份验证要求：

• 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>
  • 有关详细信息，请参阅预配Windows设备门户和自定义 SSL 证书。
  • 这样，可以安装自己的 SSL 证书来修复通常在 WDP 中看到的 SSL 警告页。
• -Debug <various options for authentication, port selection, and tracing level>
  • 运行具有特定配置和可见调试消息的独立 WDP 版本。 这最适用于生成 打包插件。
  • 有关如何以系统身份运行以完全测试打包插件的详细信息，请参阅 MSDN 杂志文章 。

Troubleshooting

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

WindowsUpdateSearch 返回无效的更新数（0x800f0950）

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

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

2. 在你想接收哪类内容？下，确保已选择Windows 的主动开发。

3. 在你希望以何种速度获取新版本下，请确保已选择Windows Insider Fast。

4. 现即可安装 FoDs。 如果已确认你使用的是 Windows Insider Fast，但仍无法安装 FoD，请提供反馈并附加 C：\Windows\Logs\CBS 下的日志文件。

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

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

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

如果在按流量计费的 Internet 连接上，可能会收到此错误。 无法在按流量计费的网络连接上下载开发者包。

另见

• Windows 设备门户概述
• Windows设备门户核心 API 参考