Skip to main content

XBOX PC Remote 工具快速入门指南

XBOX PC Toolbox 应用处于预览阶段。请从 Windows 上的 Microsoft Store 下载。

清理之前的预览版本

如果你未参加过之前的预览,请跳过此部分。否则,请按照以下清理步骤操作。

使用 PowerShell 脚本

  1. 清理脚本 下载到两台设备上。
  2. 在开发 PC 上:
    • 以管理员身份打开 PowerShell 或 PowerShell 7
    • 转到下载位置(例如:cd downloads)
    • 运行以下命令:
  1. 在目标设备上:
    • 使用 U 盘或就近共享将脚本复制到目标设备
    • 以管理员身份打开 PowerShell 或 PowerShell 7
    • 转到下载位置(例如:cd downloads)
    • 运行以下命令:

安装和设置

先决条件

  • 两台设备在设置期间都需要 Internet 访问。
  • 在两台设备上从 Microsoft Store 安装 XBOX PC Toolbox 应用。
  • 设备必须共享同一本地网络,并能够互相 ping 通。
  • 从 RETAIL 沙盒获取 XBOX PC Toolbox 应用程序。设置后,你可以切换到任何开发者沙盒。
  • 仅支持 Windows 10 或 Windows 11 家庭版或专业版。
  • 设置期间你需要对两台设备的物理访问。
  • 已加入 Microsoft Entra ID 的目标设备仅通过 Lightweight 预配支持。Fully Managed 不适用于加入了 Entra 的设备。应用会自动检测到此条件,并在设置期间禁用 Fully Managed 选项。
  • 两台设备都需要管理员访问权限。

XBOX PC Toolbox 设置所做的更改

开发 PC 配置更改

  • 启用开发人员模式。
  • 在你的“文档”文件夹中安装 PowerShell 模块。
  • 将网络适配器的配置文件设置为专用。
  • 在专用网络上启用文件和打印机共享以及网络发现。
  • 启用 Windows 远程管理 (WinRM)。
  • 安装 OpenSSH 客户端,并配置 ssh-agent 自动启动。
  • 创建供使用的 SSH 密钥。

设置期间应用的目标设备配置更改

  • 启用开发人员模式。
  • 在你的“文档”文件夹中安装 PowerShell 模块。
  • 将网络适配器的配置文件设置为专用。
  • 在专用网络上启用文件和打印机共享以及网络发现。
  • 启用 WinRM。
  • 安装 OpenSSH 服务器,并配置 sshd 自动启动。
  • 在端口 22 上为 SSH 服务器添加防火墙规则。
  • 移除睡眠和显示超时。
  • 为 PowerShell 子系统和基于密钥的身份验证配置 SSH。
  • 安装 Visual C++ 运行时可再发行组件。
  • 在端口 4275 上为 wdEndpoint 设置 netsh HTTPS 规则,以侦听传入连接。
有关已知问题和常见问题解答,请参阅 XBOX PC Remote 工具常见问题解答指南

API 参考

XBOX PC Remote Iteration API 参考

使用 XBOX PC Remote Iteration API 自动化远程部署、启动和进程管理。
最后修改于 2026年8月13日