這份逐步故障排除指南能幫助你找出並修復 Microsoft Dev Box 的連線問題。 這些問題可能包括無法連線、登入問題、頻繁斷線或高延遲。
先決條件
| 類別 | 需求 |
|---|---|
| Tools | 要建立或存取 Dev Box,組織必須設定 Microsoft Dev Box,並至少有一個專案和一個 Dev Box 池。 要為組織設定 Microsoft Dev Box,請參見 快速入門:配置 Microsoft Dev Box。 |
| Tools | 要用 Windows 應用程式連接到開發者主機,請在你的用戶端 裝置上安裝 Windows 應用程式 。 |
| 權限 | 要建立或存取 Dev Box,您需要在有可用開發環境池的專案中擁有 Dev Box 使用者權限。 如果你沒有專案權限,請聯絡你的管理員。 |
可能的快速解決方法
要自動辨識並解決開發機的問題,可以試著執行 故障排除與修復。 登入開發者入口網站,從開發者框的「更多操作」選單中選擇「故障排除與修復」。 欲了解更多資訊,請參閱「 透過故障排除與修復工具解決連線問題」。
疑難排解檢查清單
- 確認你的用戶端裝置是否有有效的網路連線。
- 確保你的客戶端裝置和開發者機器都安裝了最新的作業系統和安全更新。
- 確保你的用戶端裝置安裝了最新的 Windows 應用程式 。
- 檢查客戶端或開發機上是否有不當的網路設定或網路代理設定,可能會干擾遠端連線。
- 請確認你的開發環境狀態為 執行中。 如果狀態是停止或休眠,請從開發者入口網站開發者視窗的「更多動作」選單中選擇開始或繼續。
- 檢查 Windows 更新。 Windows 更新期間,你最多要等 30 分鐘才能連接到開發者主機。
- 如果你能進入開發者框,請在會話中選擇頂端連線列的圖示來檢視安全性和連線資訊。
- 請在針對開發箱的遠端桌面連線問題進行疑難排解中檢閱已知的連線問題。
遠端連線問題
如果 Windows 應用程式與開發者主機的連線當機或失敗,請嘗試以下步驟來連接。
- 登入開發者入口網站,並從開發者框圖塊的「更多操作」選單中選擇「重新啟動」來重新啟動開發框。
- 重新啟動後,請選擇 透過 Windows 應用程式的連接再嘗試連線。
- 試著透過瀏覽器連線,方法是選擇「 透過 Windows 連接 」旁邊的滑碼,然後選擇「 在瀏覽器中開啟」。
- 登出後再回到開發者入口網站,再嘗試連線。
- 打開工作管理員並終止所有正在運行的 msrdc.exe 或 msrdcw.exe 程序。 然後嘗試重新連線。
登入與認證問題
如果你使用正確的憑證,登入或驗證仍有問題,請嘗試以下步驟:
- 如果可能的話,請使用
dsregcmd.exe /status檢查你在客戶端裝置和開發環境上的 Microsoft Entra ID 加入狀態。 在與客服團隊解決任何錯誤後,重新啟動機器。 - 如果你一段時間沒登入開發者主機,Microsoft Entra ID 可能會因為你的帳號不活躍而移除。 若要重新取得存取權,請聯絡您的支援團隊。
- 請使用
dsregcmd.exe /refreshprt來刷新會話的主刷新令牌(PRT)。 然後登出再登入。 - 如果你有管理員權限,可以嘗試使用
dsregcmd.exe /forcerecovery進行重新認證和重新註冊,或使用dsregcmd.exe /leave和dsregcmd.exe /join離開並重新加入 Microsoft Entra ID。 欲了解更多資訊,請參閱 使用 dsregcmd 指令排除裝置問題。 - 如果您在 Azure 入口網站中擁有管理員權限,則可能需要透過刪除並重新建立開發箱集區,來將開發箱從該集區中取消訂閱,然後再將開發箱重新訂閱到該集區。
高 CPU 負載時連線問題
如果你在開發機上 CPU 負載高時經常斷線,可以套用登錄檔設定,讓遠端連線會話有更多 GPU 優先權。
確保你的開發者主機是最新的 Windows 11 版本。
打開開發者框的登錄檔編輯器,新增以下登錄檔設定。
機碼:HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations
設定: SetGpuRealtimePriority
數值: DWORD 2或者,你也可以執行此指令,在具提權的 shell 中新增並設定 SetGpuRealtimePriority 登錄檔設定及其值。
reg add "HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations" /v SetGpuRealtimePriority /d 2 /t REG_DWORD重新啟動開發機。
低 CPU 使用率時連線問題
如果你在開發機上即使 CPU 使用率低,也經常斷線,你可以將遠端桌面連線切換成傳輸控制協定(TCP)而非使用者資料報協定(UDP)。 為了確保連線只使用 TCP,請在用戶端裝置和開發機上都更改設定。
用戶端設定
明確告訴客戶端不要嘗試 UDP 連線。
- 打開本地群組政策編輯器
gpedit.msc。 - 前往 電腦設定>管理範本>Windows 元件>遠端桌面服務>遠端桌面連線客戶端。
- 將「關閉 UDP On Client」的政策設定為「已啟用」,然後選擇確定。
或者,您也可以編輯登錄檔,加入以下 fClientDisableUDP 設定:
鍵: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client
設定: fClientDisableUDP
數值:DWORD 1
您也可以透過在提升權限的殼層中執行以下命令來套用 fClientDisableUDP 登錄設定和值:
reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client" /v fClientDisableUDP /d 1 /t REG_DWORD
主機設定
用群組政策編輯器把開發機上的遠端桌面傳輸協定設定成只使用 TCP。
- 在你的開發者機上,打開本地群組政策編輯器
gpedit.msc。 - 前往 電腦設定>管理範本>Windows 元件>遠端桌面服務>遠端桌面 會話主機>連線。
- 將政策設定 「選擇 RDP 傳輸協定 」設為 啟用。
- 選擇傳輸 類型時,選擇 僅使用TCP,然後選擇 確定。
完成這些變更後,在兩台機器上在提升權限的殼層中執行 gpupdate /force 並重新啟動它們。
取得支援
如果上述步驟仍無法解決問題,您可以聯絡您的管理團隊、取得更多支援資源,或提出支援申請。
在開發者入口網站中,從開發框的「更多動作」選單選擇支援,以開啟開發框支援窗格。 在窗格中,你可以:
- 選擇 排除開發環境問題 連結,即可排除開發環境的問題。 欲了解更多資訊,請參閱「 透過故障排除與修復工具解決連線問題」。
- 選擇「複製支援詳情」以複製關於你的開發環境的詳情,以及提供給管理員或支援團隊的Issue ID。
- 選擇聯絡 Azure 說明與支援連結,開啟 Azure 入口網站的說明與支援頁面,以便管理您的 Dev Box 專案。 在 「幫助+支援 」頁面,你可以選擇「 故障排除 」的 「動作 」來逐步進行故障排除步驟,或選擇 「建立支援請求 」來逐步建立支援請求。
如果您提出支援申請,請包含:
- 問題的詳細描述。
- 問題發生的時間點。
- 受影響的使用者。
- 有關您的開發箱和遠端工作階段的其他資訊 (如果可用的話),例如活動識別碼。
取得開發箱連線與安全性資訊
如果你能進入開發者機箱,可以在遊戲過程中點選連線列頂端對應的圖示,取得安全和連線資訊。
若要查看連線細節,如 時間戳 記和 活動 ID,請在連線對話框中選擇 「查看詳情 」。 按 Ctrl+C 複製連線細節,然後選擇 確定關閉對話框。