> ## 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. # 連線 (xbconnect.exe) > 連線 (xbconnect.exe) 使用此工具設定或查詢 Microsoft Game Development Kit (GDK) 遠端工具所使用的預設主機位址。 | 欄 1 | | - | | **xbconnect** \[/B] \[/S] \[/T] \[/N] \[/D] \[/Q] \[/QG] \[/WS\[:sec] ] \[/WTP\[:sec] ] \[/WT\[:sec] ] \[/WTO\[:sec] ] \[/discover \[search string] ] \[/data] \[/?] \[*address\[+\] \[name]*] | | 選項 | 描述 | | - | - | | /B | 只顯示主機的名稱或位址，並使用精簡格式。 | | /S | 只顯示系統名稱或位址，並使用精簡格式。 | | /T | 只顯示工具的名稱或位址，並使用精簡格式。 | | /N | 不嘗試連線至目標位址。 | | /D | 顯示已註冊的擴充功能與處理序組建資訊。 | | /DX | 執行診斷測試，以評估 PC 與 XBOX 開發套件之間的連線健全狀況。如需詳細資訊，請參閱本主題稍後的「連線診斷測試的詳細資料」一節。 | | /Q | 只執行查詢，即使提供了位址也不會註冊預設位址。通常與 **/D** 一起使用，以直接查詢而不影響預設主機設定。 | | /QG | 查詢 Title OS (Game OS) 是否正在執行。只執行查詢，即使提供了位址也不會註冊預設位址。
指令碼通常會使用 **/QG** 判斷 Title OS 的狀態，以選擇存取遊戲檔案的正確方法。在指令碼中，如果遊戲正在執行，ERRORLEVEL 會設為 0，否則會設為 1。如需在指令碼中檢查 Title OS 狀態的範例，請參閱「**在指令碼中檢查 Title OS 的狀態**」一節。 | | /WS\[:sec] |
• 使 **xbconnect** 封鎖，直到系統 OS 準備好可進行互動或達到逾時為止。
• 預設逾時為 120 秒。您可以選擇指定自訂值，例如 **xbconnect /WS:200**。
• 如果主機已就緒，則傳回 ERRORLEVEL=0；如果達到逾時，則傳回 ERRORLEVEL=1。
• 提供可靠的方式來判斷主機何時準備好接收命令，例如何時可以在 **xbreboot** 之後呼叫 **xbapp launch**。
• 若要無限期等候，請使用 -1 或 "infinite"。 | | /WTP\[:sec] |
• 使 **xbconnect** 封鎖，直到遊戲處理序準備好可進行互動為止。預設逾時為 300 秒，可以提供以秒為單位的選擇性概略逾時值進行設定 (例如：/WTP:200)。使用 -1 或 'infinite' 值可無限期等候。 | | /WT\[:sec] |
• 使 **xbconnect** 封鎖，直到 Game OS 準備好可進行互動或達到逾時為止。
• 預設逾時為 120 秒。您可以選擇指定自訂值，例如 **xbconnect /WT:200**。
• 如果主機已就緒，則傳回 ERRORLEVEL=0；如果達到逾時，則傳回 ERRORLEVEL=1。
• 提供可靠的方式來判斷 Game OS 何時已完成初始化且遊戲已啟動。
• 若要無限期等候，請使用 -1 或 "infinite"。 | | /WTO\[:sec] |
• 使 **xbconnect** 封鎖，直到 Title OS 準備好可進行互動為止。預設逾時為 300 秒，可以提供以秒為單位的選擇性概略逾時值進行設定 (例如：/WTO:200)。使用 -1 或 'infinite' 值可無限期等候。 | | /discover \[search string] | 在 LAN 上搜尋 XBOX 主機，並可依選擇性的子字串篩選。搜尋字串會套用至主機的主機名稱，而非其 IP 位址。 | | /data | 傳回開發 PC 與主機之間的連線速度 (以 MBps 為單位)。 | | /? | 顯示可用選項的完整清單。 | | *address\[+\] \[name]* | *address\[+\]* 指定目標主機的主機名稱或位址 (**Tools IP**)。
• 除非指定 **/Q** 參數，否則設定位址會變更預設主機。
• 如果未指定位址，**xbconnect** 會顯示目前儲存的預設位址。
• 如需在主機上設定主機名稱的詳細資訊，請參閱[為主機 IP 位址設定主機名稱](/zh-TW/home/setup-install/dev-kit-settings/setting-a-hostname)。
使用 *accesskey* 字串，只為擁有存取金鑰的人員提供主機存取權。
• 使用 **xbconfig accesskey=your-key** 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。
• 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。
• 如果在使用 **xbconnect** 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。
• 如需存取金鑰的詳細資訊，請參閱 [xbconfig accesskey](/zh-TW/tools/tools-console/commandlinetools/xbconfig)。
使用 *name* 指定要與位址相關聯的名稱。如果未指定名稱，**xbconnect** 會使用 "devkit" 作為主機識別碼。開發工具連線至主機所應使用的 *address*，在主機上會顯示為 **Console IP**。
• 如果未指定 *address* 且尚未設定預設位址，**xbconnect** 會顯示錯誤訊息。
• 如果未指定 *address* 但已設定預設位址，**xbconnect** 會嘗試連線至預設主機的位址。這可用來確認預設主機是否仍可存取。
• 叫用其他遠端工具時，您可以使用 **/X** 參數指定開發套件，以覆寫預設主機的位址。 | | /LC | 指定地區設定代碼。用於覆寫預設的地區設定代碼 | ## 在指令碼中檢查 Title OS 的狀態 ``` @xbconnect /QG > nul @if ERRORLEVEL=1 GOTO SYSTEM @echo Title running @echo using xbcp @GOTO ENDD @:SYSTEM @echo Title not running @echo using robocopy @GOTO ENDD @:ENDD @echo Done ``` 執行指令碼會產生下列輸出。 ``` C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat Title not running using robocopy Done C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat Title running using xbcp Done ``` ## 連線診斷測試的詳細資料 **xbconnect /dx** (診斷) 會在開發 PC 本機與開發主機上執行各種測試，以判斷可能造成連線問題的原因。這些測試分為四組，每組中會執行數類測試。失敗會以紅色顯示，並附上錯誤碼以及更詳細描述該錯誤碼的文字。此外，部分測試會顯示可能有助於疑難排解的更多資料。 ### 本機 PC 測試 本機 PC 測試會在您的開發 PC 上執行，與開發主機無關。 執行中的處理序：測試為了能與 XBOX 開發主機搭配運作而應執行的處理序。測試的處理序包括下列項目： * XbtpLinkSvc.exe * XrfsSvc.exe > \[!NOTE] > 此特定處理序可能未啟動，但這不一定是真正的失敗。 ### PC 對主機測試 PC 對主機測試從開發 PC 發起，並嘗試以各種方式連線至開發主機。 * \*\*XbtpLink：\*\*測試 PC 與主機之間的 XBTP 通訊協定是否正常運作，無論是透過傳輸控制通訊協定 (TCP) 還是使用 XBOX 傳輸裝置 (XTD)。 * \*\*Query IP：\*\*要求主機傳回其已知的 IP 位址。 * \*\*Ping：\*\*嘗試使用標準網際網路控制訊息通訊協定 (ICMP) ping 所提供 IP 位址上的目標主機。 * \*\*連接埠連線：\*\*嘗試連線至開發主機上執行服務的開放連接埠。這些服務與連接埠包括下列項目： * XTF (XBOX Tools Framework)：連接埠 4201/4211/4221 * VS Debugger (Visual Studio 遠端偵錯工具)：連接埠 4024/4022/4020/4016 * Video Server (XBOX Manager 使用的遠端視訊伺服器)：連接埠 11442 * WDP (適用於 XBOX 的 Windows Device Portal)：連接埠 11443 ### 主機測試 主機測試會在遠端主機上執行，與開發 PC 無關。 * \*\*Debug NIC：\*\*判斷除了零售網路連接埠之外，是否也在使用主機上的偵錯網路連接埠。 * \*\*執行中的處理序：\*\*測試應在開發主機上執行的處理序。這些處理序包括 Xtfhost.exe。 ### 主機對 PC 測試 主機對 PC 測試從開發主機發起，並嘗試以各種方式連線至開發 PC。 * \*\*Ping：\*\*嘗試使用 PC 提供的 IP 位址 ping 目標開發 PC。 > \[!NOTE] > 系統會嘗試 PC 上的每個可路由位址，但並非所有位址都能從 XBOX 開發主機路由。此測試中特定位址失敗的情況並不少見。 * \*\*XbtpLink：\*\*測試開發 PC 與開發主機之間的 XBTP 通訊協定是否正常運作，無論是透過 TCP 還是使用 XTD。 ### 診斷輸出範例 下列螢幕擷取畫面顯示診斷輸出的範例。 xbconnect 診斷 ## 另請參閱 [命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools) [檔案複製 (xbcp.exe)](/zh-TW/tools/tools-console/commandlinetools/xbcp) [目錄 (xbdir.exe)](/zh-TW/tools/tools-console/commandlinetools/xbdir) [診斷資訊 (xbdiaginfo.exe)](/zh-TW/tools/tools-console/commandlinetools/xbdiaginfo) ## Related topics - [認證 (xbcred.exe)](/zh-TW/tools/tools-console/commandlinetools/xbcred.md) - [目錄 (xbdir.exe)](/zh-TW/tools/tools-console/commandlinetools/xbdir.md) - [追蹤 (xbtrace.exe)](/zh-TW/tools/tools-console/commandlinetools/xbtrace.md) - [佈建 (xbprovision.exe)](/zh-TW/tools/tools-console/commandlinetools/xbprovision.md) - [執行 (xbrun.exe)](/zh-TW/tools/tools-console/commandlinetools/xbrun.md)