> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX PC Remote 工具快速入门指南

> 安装 XBOX PC Toolbox 应用,并配置你的开发 PC 和目标设备。

# XBOX PC Remote 工具快速入门指南

<Info>
  XBOX PC Toolbox 应用处于预览阶段。请从 Windows 上的 [Microsoft Store](https://aka.ms/toolboxinstaller) 下载。
</Info>

## 清理之前的预览版本

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

### 使用 PowerShell 脚本

1. 将 [清理脚本](https://aka.ms/CleanupScript) 下载到两台设备上。

2. 在开发 PC 上:
   * 以管理员身份打开 PowerShell 或 PowerShell 7
   * 转到下载位置(例如:`cd downloads`)
   * 运行以下命令:

```powershell theme={null}
      pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target devpc
```

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

```powershell theme={null}
pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target targetdevice
```

## 安装和设置

### 先决条件

* 两台设备在设置期间都需要 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 工具常见问题解答指南](/tools/tools-pc/xbox-pc-remote-tools/faq)。

## API 参考

<Card title="XBOX PC Remote Iteration API 参考" icon="code" href="/reference/remoting/remoteiteration_members">
  使用 XBOX PC Remote Iteration API 自动化远程部署、启动和进程管理。
</Card>


## Related topics

- [XBOX PC Remote 工具常见问题解答和故障排除指南](/zh-CN/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [XBOX PC Remote 工具:2026 年 3 月 (2603) 发行说明](/zh-CN/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [使用 Azure Functions 的 PlayFab CloudScript 快速入门指南](/zh-CN/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)
- [欺诈防范快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)
- [游戏存档快速入门](/zh-CN/services/playfab/player-progression/game-saves/quickstart.md)