> ## 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 侦听终结点 (wdEndpoint.exe)

> XBOX PC Remote 侦听终结点 (wdEndpoint.exe)

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

XBOX PC Remote 侦听终结点 (wdEndpoint.exe) 在远程 Windows 设备上运行，并接受来自开发 PC 上 [wdRemote](/tools/tools-pc/commandlinetools/gr-wdRemote) 命令行工具的命令。这两个工具共同支持在远程 Windows 设备上构建游戏的两个关键工作流：

* 通过 PIN 配对在开发 PC 与远程设备之间建立可信、安全的连接。
* 在远程 Windows 设备上部署、启动和终止游戏。

有关 `wdRemote` 和 `wdEndpoint` 在 Windows 远程开发工具集中如何工作的概述，请参阅 [XBOX PC Remote 工具概览](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-win-gamedev)。

## 安装 wdEndpoint.exe

你可以使用 [XBOX PC Toolbox](/tools/tools-pc/xboxpctoolbox/xboxpctoolbox) 或 WinGet 安装 wdEndpoint.exe：

`winget install Microsoft.Gaming.RemoteIterationEndpoint `

当你通过 Xbox PC Toolbox 安装 `wdEndpoint` 时，用户在目标设备上登录时它会自动启动。如果你使用 WinGet 安装，则需要手动启动它。以非管理员身份运行 `wdEndpoint` 才能接受来自 `wdRemote` 的命令。

## wdEndpoint 命令

`wdEndpoint` 提供以下命令。

| 命令                                               | 描述                       |
| ------------------------------------------------ | ------------------------ |
| [wdEndpoint /createkeys](#wdEndpoint_createKeys) | 创建启用加密和设备配对所需的安全密钥。      |
| [wdEndpoint /purgekeys](#wdEndpoint_purgekeys)   | 从目标设备中移除所有安全密钥和设备配对。     |
| [wdEndpoint /createpin](#wdEndpoint_createPin)   | 创建用于配对的 PIN。             |
| [wdEndpoint /pair](#wdEndpoint_pair)             | 将远程 Windows 设备与开发 PC 配对。 |
| [wdEndpoint /noconsole](#wdEndpoint_noconsole)   | 运行 wdEndpoint 时不显示控制台窗口。 |

<a id="wdEndpoint_createKeys" />

### wdEndpoint /createkeys

`wdRemote` 与 `wdEndpoint` 之间的通信是加密的。使用 `wdEndpoint /createkeys` 命令生成加密和配对所需的安全密钥。

<Note>`wdEndpoint /createkeys` 需要目标设备上的管理员权限。</Note>

`wdEndpoint /createkeys`

[返回本主题顶部。](/tools/tools-pc/commandlinetools/gr-wdEndpoint)

<a id="wdEndpoint_purgekeys" />

### wdEndpoint /purgekeys

从目标设备中移除所有安全密钥和设备配对。

<Note>wdEndpoint /purgekeys 需要目标设备上的管理员权限。</Note>

`wdEndpoint /purgekeys`

[返回本主题顶部。](/tools/tools-pc/commandlinetools/gr-wdEndpoint)

<a id="wdEndpoint_createPin" />

### wdEndpoint /createpin

创建用于配对的 PIN。将此 PIN 用作 `/pair` 命令的参数。

`wdEndpoint /createpin`

[返回本主题顶部。](/tools/tools-pc/commandlinetools/gr-wdEndpoint)

<a id="wdEndpoint_pair" />

### wdEndpoint /pair

将远程 Windows 设备与开发 PC 配对。你可以通过两种方式配对：

1. 不带 PIN 运行 `wdEndpoint /pair`。该命令会生成并显示一个 PIN，然后等待开发 PC 返回该 PIN。如果两分钟内未返回 PIN，`wdEndpoint` 会结束配对过程。
2. 带 PIN 运行 `wdEndpoint /pair`。此模式不会阻塞或等待——它会立即开始配对。使用 `/createPin` 选项为 `/pair` 命令创建 PIN。

<Note>`wdEndpoint /pair` 需要目标设备上的管理员权限。</Note>

`wdEndpoint /pair{:PIN}`

| 选项          | 描述                 |
| ----------- | ------------------ |
| /pair:{PIN} | 在非阻塞模式下配对时使用的 PIN。 |

[返回本主题顶部。](/tools/tools-pc/commandlinetools/gr-wdEndpoint)

<a id="wdEndpoint_noconsole" />

### wdEndpoint /noconsole

运行 `wdEndpoint` 时不显示控制台窗口。当以不需要可见控制台窗口的方式启动 `wdEndpoint` 时，无控制台窗口显示很有用。

`wdEndpoint /noconsole`

[返回本主题顶部。](/tools/tools-pc/commandlinetools/gr-wdEndpoint)

## 另请参阅

[wdRemote](/tools/tools-pc/commandlinetools/gr-wdRemote)
[XBOX PC Remote 工具](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-gamedev-tools)


## Related topics

- [PC 开发的命令行工具](/zh-CN/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [如何使用 XBOX PC Remote 工具](/zh-CN/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md)
- [XBOX PC Remote (wdRemote.exe)](/zh-CN/tools/tools-pc/commandlinetools/gr-wdRemote.md)
- [命令行工具](/zh-CN/tools/tools-pc/commandlinetools/index.md)
- [在 Visual Studio 中远程调试 Windows 设备上的 PC 项目](/zh-CN/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio-remote-windows.md)