通过

远程 Windows 游戏开发常见问题解答

重要

Xbox 电脑工具箱应用处于预览状态。 若要了解详细信息，请联系Microsoft代表。

常见问题解答

问题
有哪些已知问题、依赖项和限制？
如何实现查找设备的目标设备的连接信息？
如何实现验证设备中的配置更改？
如何实现验证和更改沙盒？
如何实现为安全通道设置选择特定的网络适配器？
如何报告一个问题？
Xbox 设备管理 PowerShell 模块 (XDM) 和 wdRemote/wdEndpoint 之间有何区别？
是否需要 Xbox 设备管理 PowerShell 模块 (XDM) 和 wdRemote/wdEndpoint？
为什么首次以管理员身份运行 wdEndpoint？
是否可以将多个游戏部署到同一目标设备？
如果在部署期间网络连接断开，会发生什么情况？
是否所有通信都已加密？
应将哪个工具用于什么任务？
是否可以将这些工具用于任何 Windows 游戏？
这些工具使用哪些网络端口？

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

已知问题

  1. (Xbox 电脑设备管理器、Microsoft.PowerShell.*或 Microsoft.Windows.Developer) 安装所需工具时出错：

    • 解决方法：从 %onedrive%/Documents/PowerShell/Modules/ 中删除模块目录，然后重试。
    • 原因：OneDrive 可能会干扰 PowerShell 模块安装。 该团队正在探索模块安装目录的替代方法。

  2. OpenSSH 错误： kex_exchange_identification: read: Connection reset

    • 修复：
      • 重启目标设备。
      • 确保设备位于专用网络配置文件中;否则，防火墙可能会阻止连接。
      • 检查本地设备上的文件是否损坏 known_hosts 。
    • 注意：这是一个特定于 OpenSSH 的问题，与我们的代码无关。

  3. winget Microsoft PowerShell 7.5 installation fails (0x8A150049):

    • 解决方法：卸载 Visual Studio 2026) 随附的 PowerShell 7.6 (
    • 原因：较新版本会导致安装冲突。 在公开版本中，此问题将得到修复。

  4. 已加入域的目标设备：OpenSSH 连接仅支持基于密码的身份验证， (基于密钥的身份验证是首选，但) 不可用。

    • 注意：这会影响已加入域的 Windows 专业版设备。 该团队正在与 OpenSSH 和 AAD 团队合作，以改进未来。

  5. WinGet 命令错误 (例如，“winget 搜索”失败)

    • 解决方法： 重新启动目标设备。 此问题正在调查中。

依赖项和限制

  • 这两个设备都需要在设置过程中访问 Internet。
  • 设备必须位于同一本地网络上，并且能够相互 ping。
  • Xbox 电脑工具箱应用仅在零售沙盒中可用。 确保设备处于零售模式，以便从 Microsoft 应用商店下载。
  • 支持的设备：Windows 10或Windows 11、家庭版或专业版。
  • 在安装过程中，需要对两个设备进行物理访问。
  • 这两台设备都需要管理员访问权限才能进行设置。
  • 不支持Azure Active Directory (已加入 AAD) 的目标设备。

如何实现查找设备连接信息？

将目标设备与 Xbox 电脑工具箱配对后，连接详细信息将显示在“测试设备”屏幕上。

设备工作区连接详细信息

或者，在目标设备上使用 PowerShell：

# Open a PowerShell 7 terminal
$env:ComputerName  # Device name
$env:Username      # Username  
ipconfig           # IP address

如何实现验证设备上的配置更改？

使用设备State Configuration (DSC) 和 PowerShell 测试配置：

# Open a PowerShell 7 terminal on the DevPC
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\devPC.dsc.yaml"

# Network (usable on either device)  
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\network.dsc.yaml"

# Open a PowerShell 7 terminal on TargetDevice
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\targetDevice.dsc.yaml"

还可以在 Windows 设置中为每个设备检查配置更改。

如何实现验证和更改沙盒？

对于工具功能，请将沙盒设置为 RETAIL 。 若要检查当前配置，请运行：xblpcsandbox /get

如果未设置为 RETAIL，请使用：

XblPCSandbox.exe RETAIL

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

在设置过程中，Xbox 电脑工具箱允许你选择网络适配器。

网络适配器选择屏幕

如何报告一个问题？

在 Xbox 电脑工具箱标题栏中，选择“ 发送反馈”。 然后选择“ 报告问题”。

替换文字

包括以下详细信息：

  • 作系统版本 (Windows 10/11 版本)
  • Xbox 设备管理 $PSVersionTablePowerShell 模块问题的 PowerShell 版本 ()
  • 网络配置 (Wi-Fi/以太网、企业/家庭)
  • 错误消息 (确切文本)
  • 重现步骤
  • 使用哪个工具 (Xbox 电脑工具箱、Xbox 设备管理 PowerShell 模块wdRemote、 或 wdEndpoint)
  • 预览版

Xbox 设备管理 PowerShell 模块 (XDM) 和 wdRemote/wdEndpoint有什么区别？

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

是否同时需要 XDM 和 wdRemote/wdEndpoint？

是。 使用 XDM 建立连接，然后使用 wdRemote/wdEndpoint XDM 进行游戏部署和执行。

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

需要管理员访问权限才能创建和存储证书并绑定 HTTPS URL。 后续运行不需要提升。

是否可以将多个游戏部署到同一目标设备？

是。 将游戏部署到不同的目录，并根据需要启动。

如果在部署期间网络连接断开，会发生什么情况？

wdRemote 将显示错误。 在还原连接后重试部署命令。

是否所有通信都已加密？

是。 开发电脑和目标设备之间的所有通信都已加密。

应对每个任务使用哪个工具？

  • Xbox 电脑工具箱：远程预配和获取设备、设置安全通道、安装依赖项以及配置设备。
  • 测试连接性：在部署游戏之前使用 Xbox 电脑工具箱。
  • 远程会话：使用已启用 XDM 的远程会话和 PowerShell 远程处理在目标设备上执行命令。
  • wdRemote/wdEndpoint：部署、测试和终止游戏。

是否可以将这些工具用于任何 Windows 游戏？

是。 这些工具适用于任何 Windows 可执行文件，而不仅仅是 GDK 游戏。

这些工具使用哪些网络端口？

  • XDM：SSH (端口 22)
  • wdEndpoint：HTTPS (端口 4275)
  • Last updated on