​

XBOX PC Remote 工具常见问题解答和故障排除指南

​

常见问题

​

Fully Managed 和 Lightweight 设备类型有什么区别?

​

在哪里可以找到应用版本号?

​

有哪些已知问题、依赖项和限制?

​

已知问题

1. PowerShell/DSC 设置可能失败,且 XBOX PC Toolbox 在设置期间可能意外关闭。
   • 解决方法: 请参阅 PowerShell 和 DSC 预配在设置期间失败。
2. 已加入域的目标设备:在 Fully Managed 模式下,OpenSSH 连接仅支持基于密码的身份验证(首选基于密钥的身份验证,但不可用)。Lightweight 预配可作为已加入域设备的替代方案。
   • 注意:此问题影响使用 Fully Managed 模式的已加入域的 Windows Pro 设备。团队正在与 OpenSSH 和 Microsoft Entra ID 团队合作以进行未来改进。
3. WinGet 命令错误(例如,winget search 失败)
   • 解决方法: 重新启动目标设备。产品团队正在调查此问题。
4. Visual Studio 调试器性能:XBOX PC Remote Debugger 尚未针对性能进行优化。预计调试时间比本地调试要慢。将来的版本会改善调试器性能。
5. XBOX PC Remote Debugger 在几次调试迭代后可能会停止响应。在大约 50 次迭代后重新启动目标设备。
   • 解决方法: 重新启动目标设备,然后重新启动调试器会话。

​

依赖项和限制

• 两台设备在设置期间都需要 Internet 访问。
• 设备必须位于同一本地网络上,并且能够互相 ping 通。
• XBOX PC Toolbox 应用仅在 RETAIL 沙盒中可用。请确保设备处于 RETAIL 模式,才能从 Microsoft Store 下载。
• 受支持的设备:Windows 10 或 Windows 11,家庭版或专业版。
• 设置期间需要对两台设备的物理访问。
• 设置期间需要两台设备的管理员访问权限。
• 已加入 Microsoft Entra ID 的目标设备仅通过 Lightweight 预配支持。Fully Managed 不适用于加入了 Entra 的设备。应用会自动检测到这一点,并在设置期间禁用 Fully Managed 选项。

​

从开发 PC 取消配对是否会完全断开设备的连接?

​

如何查找设备连接信息?

# 打开一个 PowerShell 7 终端
$env:ComputerName  # 设备名称
$env:Username      # 用户名  
ipconfig           # IP 地址

​

如何验证设备上的配置更改?

# 在 DevPC 上打开一个 PowerShell 7 终端
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\devPC.dsc.yaml"

# 网络(可在任一设备上使用)  
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\network.dsc.yaml"

# 在 TargetDevice 上打开一个 PowerShell 7 终端
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\targetDevice.dsc.yaml"

​

如何验证和更改沙盒?

​

如何为安全通道设置选择特定的网络适配器?

​

如何报告问题?

• 操作系统 版本 (Windows 10/11 版本)
• 对于 XBOX Device Management PowerShell Module 问题,请提供 PowerShell 版本 ($PSVersionTable)
• 网络配置 (Wi-Fi/以太网、公司/家庭)
• 错误消息(确切文本)
• 重现步骤
• 你使用的是 哪个工具(XBOX PC Toolbox、XBOX Device Management PowerShell Module、wdRemote 或 wdEndpoint)
• 预览版本

​

XBOX Device Management PowerShell Module (XDM) 与 wdRemote/wdEndpoint 有什么区别?

• XDM:设置安全通信通道。
• wdRemote/wdEndpoint:通过这些通道部署和启动游戏。

​

我同时需要 XDM 和 wdRemote/wdEndpoint 吗?

​

为什么第一次要以管理员身份运行 wdEndpoint?

​

我可以将多个游戏部署到同一目标设备吗?

​

如果在部署过程中网络连接断开会发生什么?

​

所有通信都加密吗?

​

我应该为每项任务使用哪个工具?

• XBOX PC Toolbox:使用它来远程预配和获取设备、设置安全通道、安装依赖项以及配置设备。
• 测试连接:在部署游戏之前使用 XBOX PC Toolbox。
• 远程会话:使用启用了 XDM 的远程会话和 PowerShell 远程处理在目标设备上执行命令。
• wdRemote/wdEndpoint:使用这些工具来部署、测试和终止游戏。

​

这些工具可以用于任何 Windows 游戏吗?

​

这些工具使用什么网络端口?

• XDM:SSH(端口 22)
• wdEndpoint:HTTPS(端口 4275)

​

故障排除指南

​

在公司网络环境中配对失败

• 验证两台设备在网络上是否彼此可见。公司防火墙或网络分段可能会阻止设备到设备的通信。
• 确保设备之间开放了以下端口:端口 22(OpenSSH)和 端口 4275(Remote Iteration 工具)。
• 在尝试配对或连接之前断开任何 VPN 连接。
• 如果你的组织需要设备注册,请根据你的 IT 策略确认你的设备已注册。

​

安装所需工具时出错

• 解决方法:从 %onedrive%/Documents/PowerShell/Modules/ 中删除模块目录并重试。
• 原因:OneDrive 可能会干扰 PowerShell 模块的安装。

​

PowerShell 和 DSC 预配在设置期间失败

• 打开提升的终端并运行:

winget uninstall Microsoft.PowerShell
winget uninstall Microsoft.DSC
winget install Microsoft.PowerShell --installer-type wix
winget install Microsoft.DSC --installer-type zip

• 如果在这些步骤后安装 DSC 时挂起,请重新启动 XBOX PC Toolbox 并重试。

​

OpenSSH 错误:kex_exchange_identification: read: Connection reset

• 重新启动目标设备。
• 确保设备位于专用网络配置文件上;否则,防火墙可能会阻止连接。
• 检查本地设备上是否有损坏的 known_hosts 文件。

​

winget Microsoft PowerShell 7.5 安装失败 (0x8A150049)

• 解决方法:卸载 PowerShell 7.6(Visual Studio 2026 附带)。较新版本会导致安装冲突。

​

配对后通过 SSH 运行 winget 失败

• 解决方法:在目标设备上运行 Repair-WinGetPackageManager,或重新启动目标设备。
• 原因:此问题发生在 SSH 连接上。

​

掌上设备上的游戏部署失败

• 解决方法:调整目标设备的电源设置,防止其在部署期间进入睡眠状态。请确保在部署期间将设备的睡眠计时器设置为较长的持续时间或禁用它。
• 原因:XBOX PC Toolbox 不再通过 DSC 管理设备电源设置。在具有激进睡眠计时器的掌上设备上,设备在部署过程中进入睡眠状态,导致 wdRemote 失败。

​

配对在远程目标设备上显示成功,但开发 PC 上的 SSH 连接失败

Get-Service sshd

Restart-Service sshd

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey" -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

• 如果此命令 成功,则 ssh-agent 正在缓存错误的密钥。按照以下步骤修复。
• 如果此命令 失败,则问题出在远程目标设备端。要进一步诊断,请参阅 如何收集 OpenSSH 日志。

# 清除所有缓存的密钥
ssh-add -D

# 重启代理服务
Restart-Service ssh-agent

# 仅重新添加正确的密钥
ssh-add "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey"

# 验证仅加载了你的密钥
ssh-add -l

# 测试连接
ssh -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

​

如何收集 OpenSSH 日志

1. 以管理员身份打开 记事本。
2. 打开文件 C:\ProgramData\ssh\sshd_config。

3. 找到以 # Logging 开头的部分,并将:
   # Logging
   #SyslogFacility AUTH
   #LogLevel INFO
   
   更改为:
   # Logging
   SyslogFacility LOCAL0
   LogLevel Debug3
   
4. 以管理员身份打开 PowerShell 终端并重新启动 SSH 服务:
   net stop sshd
   net start sshd
   
5. 在 XBOX PC Toolbox 应用中重现该问题。
6. 从 C:\ProgramData\ssh\logs 收集日志。将该文件夹压缩为 .zip 文件以与开发团队共享。
7. 收集日志后,还原在步骤 3 中所做的更改(在每行的开头重新添加 #),并再次使用步骤 4 重新启动 SSH 服务。

​

另请参阅

• 如何使用 XBOX PC Remote 工具
• XBOX PC Remote 工具快速入门指南
• XBOX PC Remote 工具概述