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

# XBOX PC Toolbox

> XBOX PC Toolbox 可設定 Windows 裝置以進行遠端遊戲開發。您可以安全地配對裝置、安裝工具，並連線至已配對的裝置進行部署。

# XBOX PC Toolbox

> [!NOTE]
>
> XBOX PC Toolbox 應用程式目前為預覽版。請從 Windows 上的 [Microsoft Store](https://aka.ms/toolboxinstaller) 下載。

XBOX PC Toolbox 可簡化遠端遊戲開發所用 Windows 裝置的設定與管理。使用此應用程式來設定開發裝置與目標裝置、安全地配對裝置、安裝必要的工具與附加元件，以及連線至已配對的裝置以進行部署與反覆開發。

> [!NOTE]
>
> 我們重視您的意見反應。若要建議功能或回報問題，請在應用程式中選取 **Send Feedback**。

* [使用者介面](#user-interface)
* [使用 XBOX PC Toolbox](#using-xbox-pc-toolbox)
* [傳送意見反應](#send-feedback)

## 使用者介面

XBOX PC Toolbox 應用程式介面包含下列主要區域：

* **Device Workspace**：探索已配對的裝置、安裝工具，以及連線以進行啟動、部署與終止應用程式等遠端工作流程。
* **Pair device**：輸入裝置的別名、IP 位址或裝置名稱、使用者名稱以及唯一的 PIN，以新增裝置。如果您未在 2 分鐘內使用 PIN，應用程式會產生新的 PIN。
* **Connect**：在已配對的 Fully Managed 目標裝置上，選取 **Connect** 以開啟遠端 PowerShell 工作階段。Lightweight 目標裝置無法使用此按鈕。在開發電腦的命令列終端機中使用 `wdRemote`，即可在任一種目標裝置類型上部署、啟動或終止遊戲。
* **Install tools**：在您的電腦或遠端目標裝置上安裝開發工具。
* **Settings**：使用導覽列中的設定圖示來檢視您的裝置資訊、存取版本資訊、傳送意見反應，或對 XBOX PC Toolbox 進行疑難排解與重設。使用每個已配對裝置上的齒輪圖示來取消配對、編輯裝置名稱或更新連線設定。

![XBOX PC Toolbox 應用程式介面](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/pctoolbox-ui.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=fd47e1e197fe988a673e3ef357c9632c)

> [!NOTE]
>
> XBOX PC Toolbox 支援遊戲台導覽。您可以使用遊戲台在畫面之間移動、選取選項以及完成設定流程，就像使用鍵盤一樣。應用程式會在所有畫面 (包括錯誤與成功對話方塊) 中一致地管理焦點。

## 使用 XBOX PC Toolbox

### 開始使用

1. 從 Windows 上的 Microsoft Store 下載 XBOX PC Toolbox。
2. 配對您的裝置並完成設定。
3. 開始使用您的遠端開發環境。

### 先決條件

* 兩部裝置都必須執行最新版的 Windows 家用版或專業版。
* 使用您的個人 Microsoft 帳戶 (MSA) 登入遠端目標裝置。
* 您在兩部裝置上都需要系統管理員權限。
* 兩部裝置必須位於相同的有線或無線網路上。
* 避免使用來自 Microsoft Store 的自訂沙箱環境。

### 部署遊戲組建

XBOX PC Toolbox 會在您的開發電腦上安裝命令列工具 `wdRemote.exe`，並在遠端目標裝置上安裝 `wdEndpoint`。若要部署您的遊戲：

`wdRemote /action:deploy /device:mypc1 /source:c:\game /destination:gamedir`

此命令會將您的遊戲檔案以累加方式複製到遠端目標的遊戲目錄。

> [!NOTE]
>
> 預設目錄為：
> `C:\ProgramData\Microsoft\GDK\wdEndpoint\gameroot\GameDir`

### 啟動遊戲

部署之後，在遠端目標裝置上啟動遊戲：

`wdRemote /action:launch /device:mypc1 /path:gamedir\game.exe`

遊戲會在遠端目標硬體上啟動。

### 終止遊戲

若要結束執行中的遊戲：

`wdRemote /action:terminate /device:mypc1`

### 疑難排解與重設

在 **Settings** 中，選取 **Troubleshoot and Reset**，然後選取最符合您情況的選項：

![XBOX PC Toolbox 中 Troubleshoot and Reset 選項](https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/images/gdk/tools/troubleshoot-and-reset.png)

* **Check XBOX PC Toolbox Configuration**：檢查由 XBOX PC Toolbox 管理的設定與元件是否已正確設定。此選項不會進行任何變更。結果與建議的修正方式會顯示在 **Home** 畫面上。

  ![Home 畫面上 XBOX PC Toolbox 設定檢查成功結果](https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/images/gdk/tools/configuration-check-results.png)
* **Repair XBOX PC Toolbox Installation**：檢查必要的 XBOX PC Toolbox 元件，並重新套用目前裝置角色的設定。您的裝置角色、配對、金鑰與已儲存的 XBOX PC Toolbox 資料都會保留。當設定不完整或無法再正常運作時，請使用此選項。
* **Start over with XBOX PC Toolbox**：移除您的裝置角色、配對、金鑰與設定，然後讓您回到首次執行設定。使用此選項來變更裝置角色，或完全重新進行 XBOX PC Toolbox 設定。

> [!WARNING]
>
> **Start over with XBOX PC Toolbox** 會從裝置移除所有配對與金鑰。

## 傳送意見反應

使用 XBOX PC Toolbox 應用程式中的**意見反應中樞**回報問題或建議改進：

1. 從應用程式的標題列選取 **Send Feedback**。
2. 選取 **Report a Problem**。

   ![意見反應中樞中 Send Feedback 下拉式功能表](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/tools/Feedback-icon.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=f91a42b4810edd3f28fcdc30b1353013)
3. 輸入您的意見反應詳細資料，然後選取 **Next**。

   ![XBOX PC Toolbox 應用程式中意見反應對話方塊](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/feedback-1.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=6b09103cf131656550dd1669dbf207c1)
4. 在 Gaming and XBOX > Developer Tools 底下選取類別：**Problem** 或 **Suggestion**，然後選取 **Next**。

   ![意見反應中樞中類別](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/feedback-2.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=1b2170c4a559708251830d51aeff410e)
5. 新增意見反應，或選取相符的選項。
6. 如果問題阻礙了您的工作流程，請勾選方塊並選取最適合的描述。

   ![意見反應中樞](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/feedback-3.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=29444f9a90b6fe028538cd5a4103746f)
7. 視需要附加檔案，然後選取 **Submit**。

   ![意見反應中樞最後一個索引標籤](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/feedback-4.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=3520bd4bf90b9a44a69eb069c6d622fa)

如需有關如何透過 XBOX PC Toolbox 應用程式開始佈建遠端 Windows 裝置並進行反覆開發的詳細逐步解說，請參閱 [XBOX PC 遠端工具操作指南](https://docs.xbox.com/zh-TW/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md)。

如需最新更新，請參閱 [XBOX PC 遠端工具版本資訊](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/get-started-with-remote-devices/release-notes/rwd-release-notes-2609)。


## Related topics

- [適用於遠端 Windows 裝置的 XBOX PC Toolbox 應用程式](https://docs.xbox.com/zh-TW/tools/tools-pc/xboxpctoolbox/index.md)
- [適用於 XBOX GDK 的 PC 開發人員工具](https://docs.xbox.com/zh-TW/tools/tools-pc/index.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/zh-TW/reference/remoting/remoteiteration_members.md)
- [XBOX PC 遠端工具](https://docs.xbox.com/zh-TW/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [如何使用 XBOX PC 遠端工具](https://docs.xbox.com/zh-TW/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md)