針對常見的 Azure 虛擬桌面代理程式問題進行疑難排解

發行項
01/22/2025

Azure Virtual Desktop Agent 可能會因為下列多種因素而造成連線問題：

訊息代理程式的錯誤導致代理程式停止服務。
發生更新問題。
代理程式安裝期間安裝的問題，這會中斷與會話主機的連線。

本文會引導您了解這些常見案例的解決方案，以及如何解決連線問題。

注意

如需工作階段連線與 Azure 虛擬桌面代理程式等相關問題的疑難排解，建議您移至 [事件檢視器] > [Windows 記錄] > [應用程式]，以檢閱工作階段主機虛擬機器 (VM) 上的事件記錄檔。尋找具有下列其中一個來源的事件，以識別您的問題：

WVD-Agent
WVD-Agent-Updater
RDAgentBootLoader
MsiInstaller

錯誤：RDAgentBootLoader 和/或 Remote Desktop Agent Loader 已停止執行

如果您看到下列任一問題，表示載入代理程式的開機載入器無法正確安裝代理程式，而且代理程式服務未在您的工作階段主機 VM 上執行：

RDAgentBootLoader 已停止或未執行。
[Remote Desktop Agent Loader] $遠端桌面代理程式載入器$ 沒有狀態。

若要解決此問題，請啟動 RDAgent 開機載入器：

在 [ 服務 ] 視窗中，以滑鼠右鍵按兩下 [遠端桌面代理程式載入器]。
選取 [開始]。如果此選項呈現灰色，表示您沒有系統管理員許可權。您必須取得這些許可權才能啟動服務。
等候 10 秒，然後以滑鼠右鍵按兩下 [遠端桌面代理程式載入器]。
選取重新整理。
如果服務在您啟動並重新整理之後停止，您可能會發生註冊失敗。如需詳細資訊，請參閱 INVALID_REGISTRATION_TOKEN or EXPIRED_MACHINE_TOKEN。

錯誤：INVALID_REGISTRATION_TOKEN or EXPIRED_MACHINE_TOKEN

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您看到識別碼為 3277 且描述中有 INVALID_REGISTRATION_TOKEN 或 EXPIRED_MACHINE_TOKEN 的事件，則表示已使用的註冊金鑰無法辨識為有效。

若要解決此問題：

依照產生註冊金鑰中的步驟建立新的註冊金鑰。

以系統管理員身分開啟 PowerShell 提示字元，然後執行下列 Cmdlet，將新的註冊密鑰新增至登錄。將 <RegistrationToken> 取代為您產生的新註冊權杖。

$newKey = '<RegistrationToken>'

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name "IsRegistered" -Value 0 -Force
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name "RegistrationToken" -Value $newKey -Force

執行下列 Cmdlet 以重新啟動 RDAgentBootLoader 服務：
```
Restart-Service RDAgentBootLoader
```

執行下列 Cmdlet 以確認已 IsRegistered 設定為 1 ，且 RegistrationToken 為空白。

Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name IsRegistered | FL IsRegistered
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name RegistrationToken | FL RegistrationToken

輸出應該類似下列輸出：

IsRegistered : 1

RegistrationToken :

檢查您的會話主機是否可在主機集區中使用。如果不是這種情況，請檢視事件檢視器項目，並查看是否有任何錯誤導致代理程式無法啟動。

錯誤：代理程式無法使用 INVALID_FORM 連線至訊息代理程式

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3277 INVALID_FORM 的事件，代理程式無法連線到訊息代理程式或到達特定端點。此問題可能是由特定防火牆或 DNS 設定所造成。

若要解決此問題，請檢查您是否可以連線到 BrokerResourceIdURI 稱為和 BrokerResourceIdURIGlobal的兩個端點：

開啟 [登錄編輯程式]。
移至HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent。
記下和BrokerResourceIdURIGlobal的值BrokerResourceIdURI。
開啟網頁瀏覽器，在網址列中輸入的值BrokerResourceIdURI，然後將 /api/health 新增至結尾，例如 https://rdbroker-g-us-r0.wvd.microsoft.com/api/health。
在瀏覽器中開啟另一個索引標籤，在網址列中輸入您的值BrokerResourceIdURIGlobal，然後將 /api/health 新增至結尾，例如 https://rdbroker.wvd.microsoft.com/api/health。
如果您的網路未封鎖訊息代理程式的連線，則將會成功載入這兩個頁面，並顯示內容為RD 訊息代理程式狀況良好的訊息，如下列螢幕擷取畫面所示：
如果網路封鎖訊息代理程式連線，頁面將不會載入，如下列螢幕快照所示。

您必須將所需的端點解除封鎖，然後重複步驟 4 到 7。如需詳細資訊，請參閱必要的 URL 清單。
如果遵循上述步驟無法解決問題，請確定您沒有任何組策略使用加密封鎖代理程式到訊息代理程序連線。 Azure 虛擬桌面使用與 Azure Front Door 相同的 TLS 1.2 加密。如需詳細資訊，請參閱連線安全性。

錯誤：3703

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3703 RD Gateway Url: is not accessible 的事件，則代理程式無法連線到閘道 URL。若要成功連線至您的工作階段主機，則必須從必要 URL 清單中允許 URL 的網路流量。此外，請確定您的防火牆或 Proxy 設定不會封鎖這些 URL。必須解除封鎖這些 URL 才能使用 Azure 虛擬桌面。

如要解決此問題，請執行必要的 URL 檢查工具，確認您是否可以存取必要的 URL。如果您使用 Azure 防火牆，請參閱使用 Azure 防火牆來保護 Azure 虛擬桌面部署和 Azure 防火牆 DNS 設定，以取得如何設定 Azure 虛擬桌面的詳細資訊。

錯誤：3019

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您看到標識碼為 3019 的事件，代理程式無法連線到 Web 套接字傳輸 URL。如要成功連線至您的工作階段主機，並允許網路流量略過這些限制，您必須將必要的 URL 清單中列出的 URL 解除封鎖。請與網路小組合作，以確定您的防火牆、Proxy 與 DNS 設定不會封鎖這些 URL。您也可以檢查網路追蹤記錄，以識別 Azure 虛擬桌面服務遭到封鎖的位置。若開啟此特定問題的 Microsoft 支援服務案例，請務必將您的網路追蹤記錄連結至要求。

錯誤：InstallationHealthCheckFailedException

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3277 InstallationHealthCheckFailedException 的事件，堆疊接聽程式無法運作，因為終端伺服器已切換堆棧接聽程式的登錄機碼。

若要解決此問題：

檢查堆棧接聽程式是否正常運作。
若堆疊接聽程式無法運作，請手動解除安裝並重新安裝堆疊元件。

錯誤：ENDPOINT_NOT_FOUND

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3277 ENDPOINT_NOT_FOUND 的事件，訊息代理程式找不到用來建立連線的端點。發生此連線問題可能是因為下列其中一個原因：

主機集區中沒有工作階段主機 VM。
主機集區中的工作階段主機 VM 並非使用中。
主機集區中的所有會話主機 VM 都已超過會話限制上限。
主機集區中的 VM 沒有任何代理程式服務在它們上執行。

若要解決此問題：

請確定 VM 已開機，且尚未從主機集區中移除。
請確定 VM 未超過最大工作階段限制。
請確定代理程式服務正在執行，且堆疊接聽程式正在運作中。
請確定代理程式可以連線至訊息代理程式。
請確定您的 VM 具備有效的註冊權杖。
請確定 VM 註冊權杖尚未到期。

錯誤：InstallMsiException

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3277 InstallMsiException 的事件，則安裝程式已在嘗試安裝代理程式時執行另一個應用程式，或組策略封鎖 msiexec.exe 執行。

若要檢查組策略是否封鎖 msiexec.exe 執行：

從提升許可權的命令提示字元執行 rsop.msc，以開啟原則的結果集。
在快顯的 [原則結果集] 視窗中，移至 [計算機>設定系統管理範本>] [Windows 元件>] [Windows Installer 關閉 Windows Installer]。> 如果狀態為 [已啟用]，請與您的 Active Directory 小組合作，以允許 msiexec.exe 執行。

注意

這不是完整的原則清單，只是我們目前已知的原則清單。

錯誤：Win32Exception

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3277 InstallMsiException 的事件，原則會封鎖 cmd.exe 啟動。封鎖此程式可防止您執行主控台視窗，其為每當代理程式更新時，您需要用於重新啟動服務的視窗。

從提升許可權的命令提示字元執行 rsop.msc，以開啟原則的結果集。
在快顯的 [原則結果集] 視窗中，移至 [使用者>設定系統管理範本>系統>防止存取命令提示字元]。 如果狀態為 [已啟用]，請與您的 Active Directory 小組合作，以允許 cmd.exe 執行。

錯誤：堆疊接聽程式無法在 Windows 10 2004 工作階段主機 VM 上運作

在您的工作階段主機 VM 上，從命令提示字元執行 qwinsta.exe ，並記下資料行中旁邊rdp-sxsSESSIONNAME出現的版本號碼。 STATE如果和 rdp-sxs 項目的數據行rdp-tcp不是 Listen，或如果未rdp-tcp列出和 rdp-sxs 專案，則表示有堆棧問題。堆疊更新會隨著代理程式更新一起安裝，但若更新未成功，則 Azure 虛擬桌面接聽程式將無法運作。

若要解決此問題：

開啟註冊表編輯器。
移至 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations。
在底下 WinStations，您可能會看到數個不同堆疊版本的資料夾。選取符合您在命令提示字元中執行 qwinsta.exe 時所看到的版本資訊的資料夾。
- 尋找 fReverseConnectMode 並確定資料值為 1。此外，請確定已 fEnableWinStation 設定為 1。
- 如果未 fReverseConnectMode 設定為 1，請選取 fReverseConnectMode 並輸入 1 其值欄位中。
- 如果未 fEnableWinStation 設定為 1，請選取 fEnableWinStation 並輸入 1 其值欄位。
針對在命令提示字元中執行 qwinsta.exe 時所看到版本資訊的每個資料夾重複上述步驟。
提示

若要一次變更多個 VM 的 fReverseConnectMode 或 fEnableWinStation 模式，您可以執行下列兩件事之一：
- 從您已運作的機器匯出登錄機碼，並將其匯入需要此變更的所有其他機器。
- 建立群組原則物件 (GPO)，以設定需要變更的機器其登錄機碼值。
重新啟動您的工作階段主機 VM。
開啟註冊表編輯器。
移至 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\ClusterSettings。
在下 ClusterSettings，尋找 SessionDirectoryListener 並確定其數據值為 rdp-sxs<version number，其中 <version number> 符合您在命令提示字元中執行 qwinsta.exe 時所看到的版本資訊。
如果未SessionDirectoryListener設定為 rdp-sxs<version number，您必須遵循此處未列出問題或未解決一節中的步驟。

錯誤：DownloadMsiException

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3277 DownloadMsiException 的事件，RDAgent 的磁碟上沒有足夠的空間。

若要解決此問題，請依照下列方式在您的磁碟上建立空間：

刪除已不在使用中的檔案。
增加工作階段主機 VM 的儲存體容量。

錯誤：代理程式無法使用 MissingMethodException 進行更新

在您的工作階段主機 VM 上，移至 [事件檢視器] > [Windows 記錄] > [應用程式]。如果您在描述中看到標識碼為 3389 MissingMethodException: Method not found 的事件，Azure 虛擬桌面代理程式未成功更新並還原為舊版。此問題可能會發生，因為 VM 上目前安裝的 .NET Framework 版本號碼低於 4.7.2。若要解決此問題，您必須遵循 .NET Framework 文件中的安裝指示，將 .NET 升級至 4.7.2 版或更新版本。

錯誤：會話主機 VM 停滯在升級狀態

若主機集區中針對工作階段主機列出的狀態一律顯示無法使用或正在升級，則代理程式或堆疊安裝失敗。

若要解決此問題，請重新安裝並存堆疊：

以系統管理員身分登入工作階段主機 VM。
從提升許可權的 PowerShell 提示字元中，執行 qwinsta.exe 並記下數據行旁rdp-sxsSESSIONNAME出現的版本號碼。 STATE如果和 rdp-sxs 項目的數據行rdp-tcp不是 Listen，或如果未rdp-tcp列出和 rdp-sxs 專案，則表示有堆棧問題。
執行下列命令來停止 RDAgentBootLoader 服務：
```
Stop-Service RDAgentBootLoader
```
移至 [控制台> 程式>與功能]，或在 Windows 11 上，移至 [設定應用程式應用程式]。>
將最新版本的 遠端桌面服務 SxS 網路堆疊 或登錄編輯器 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations 中所列的版本卸載，其值 ReverseConnectionListener之下。

回到 PowerShell 提示字元，執行下列 Cmdlet，將會話主機 VM 上可用的最新安裝程式檔案路徑新增至變數，並列出其名稱：

$sxsMsi = (Get-ChildItem "$env:SystemDrive\Program Files\Microsoft RDInfra\" | ? Name -like SxSStack*.msi | Sort-Object CreationTime -Descending | Select-Object -First 1).FullName
$sxsMsi

執行下列 Cmdlet，在您的工作階段主機 VM 上安裝可供並存堆疊使用的最新安裝程式：
```
msiexec /i $sxsMsi
```
重新啟動您的工作階段主機 VM。
從命令提示字元中，再次執行 qwinsta.exe ，並確認 STATE 和 rdp-sxs 項目的數據行rdp-tcp為 Listen。如果不是，您必須重新註冊 VM，然後重新安裝代理程式元件。

錯誤：工作階段主機卡在無法使用狀態

如果您的工作階段主機 VM 停滯在無法使用狀態，則您的 VM 未透過健康情況檢查中所列的其中一個健康情況檢查項目。您必須解決導致 VM 無法進行健康情況檢查的問題。

錯誤：工作階段主機停滯在「需要協助」狀態

數個健康情況檢查可能會導致您的會話主機 VM 卡在 [需要協助] 狀態：UrlsAccessibleCheck、MetaDataServiceCheck 和 MonitoringAgentCheck。

UrlsAccessibleCheck

如果會話主機未通過 UrlsAccessibleCheck 健康情況檢查，您必須識別部署目前封鎖的必要 URL 。一旦您知道封鎖了哪個 URL，請識別封鎖該 URL 的設定並予以移除。

服務封鎖必要 URL 的原因有兩個：

您有作用中的防火牆會封鎖大部分的輸出流量，並存取所需的 URL。
您的本機主機檔案封鎖必要的網站。

若要解決防火牆相關問題，請新增規則，以允許與封鎖 URL 相關聯 TCP 連接埠 80/443 的輸出連線。

如果您的本機主機檔案封鎖必要的 URL，請確定您裝置上的 Hosts 檔案中沒有任何必要的 URL。您可以在下列登錄機碼和值中找到 Hosts 檔案的位置：

索引鍵：HKLM\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

類型:REG_EXPAND_SZ (英文)

名稱：DataBasePath

MetaDataServiceCheck

如果會話主機未通過 MetaDataServiceCheck 健康情況檢查，服務就無法存取 IMDS 端點。若要解決此問題，您需要執行下列動作：

重新設定您的網路、防火牆或 Proxy 設定，以解除封鎖 IP 位址 169.254.169.254。
查詢 IMDS 時，確保 HTTP 用戶端略過 VM 內的 Web Proxy。建議您在 VM 內處理輸出網路流量方向的任何防火牆原則中，允許必要的 IP 位址。

如果您的問題是由 Web Proxy 所造成，請在 Web Proxy 的設定中新增 169.254.169.254 的例外狀況。若要新增此例外狀況，請開啟提升權限的命令提示字元或 PowerShell 工作階段，然後執行下列命令：

netsh winhttp set proxy proxy-server="http=<customerwebproxyhere>" bypass-list="169.254.169.254"

MonitoringAgentCheck

如果會話主機未通過 MonitoringAgentCheck 健康情況檢查，您需要檢查遠端桌面服務基礎結構日內瓦代理程式，並驗證它是否在會話主機上正常運作：

確認遠端桌面服務基礎結構日內瓦代理程式是否已安裝在工作階段主機上。您可以在工作階段主機上已安裝的程式清單中確認這一點。如果您看到已安裝此代理程式的多個版本，請卸載舊版，並只保留最新版本。
如果您在會話主機上找不到已安裝遠端桌面服務基礎結構日內瓦代理程式，請檢閱位於 C：\Program Files\Microsoft RDInfra\GenevaInstall.txt 下的記錄，並查看安裝是否因為錯誤而失敗。
確認是否已建立排程的工作GenevaTask_version>。< 此排程工作必須啟用並執行。如果不是，請使用名為 Microsoft.RDInfra.Geneva.Installer-x64-version<>.msi 的檔案重新安裝代理程式.msi，該檔案可在 C：\Program Files\Microsoft RDInfra 取得。

錯誤：找不到連線：RDAgent 沒有與訊息代理程式的作用中連線

您的會話主機 VM 可能處於連線限制，且無法接受新的連線。

若要解決此問題，請執行下列任一項操作︰

減少會話限制上限。這項變更可確保資源會更平均地分散到會話主機，並防止資源耗盡。
增加工作階段主機 VM 的資源容量。

錯誤：操作 Pro VM 或其他不支援的 OS

並存堆疊僅受 Windows Enterprise 或 Windows Server SKU 支援，這表示不支援 PRO VM 等作業系統。如果您沒有企業或伺服器 SKU，堆疊會安裝在您的 VM 上，但未啟用，因此當您在命令行中執行 qwinsta.exe 時，它不會出現。

若要解決此問題，請使用支援的作業系統來建立工作階段主機 VM。

錯誤：NAME_ALREADY_REGISTERED

工作階段主機 VM 的名稱已註冊，可能是重複的名稱。

若要解決此問題：

請遵循步驟，從主機集區中移除會話主機。
建立另一個 VM。請務必為此 VM 選擇唯一名稱。
移至 Azure 入口網站，然後開啟 VM 所在主機集區的 [概觀] 頁面。
開啟 [工作階段主機] 索引標籤，並檢查以確定所有工作階段主機都位於該主機集區中。
等候 5-10 分鐘，讓會話主機狀態顯示 [可用]。

您的問題未列在此處或未解決

若在本文中找不到您的問題，或指示沒有幫助，建議您解除安裝、重新安裝並重新註冊 Azure 虛擬桌面代理程式。此區段中的指示將示範如何透過下列方式向 Azure 虛擬桌面服務重新註冊您的工作階段主機 VM：

卸載所有代理程式、開機載入器和堆疊元件。
從主機集區移除會話主機。
為 VM 產生新的註冊金鑰。
重新安裝 Azure 虛擬桌面代理程式和開機載入器。

若您的情況適用下列一或多個案例，請遵循此區段中的下列指示：

工作階段主機 VM 的狀態停滯為 [正在升級] 或 [無法使用]。
您的堆棧接聽程式無法運作，而且您正在 Windows 10 版本 1809、1903 或 1909 上執行。
您收到 EXPIRED_REGISTRATION_TOKEN 錯誤。
您未看到自己的工作階段主機 VM 顯示於工作階段主機清單中。
您未在 [服務] 主控台中看到 [Remote Desktop Agent Loader] $遠端桌面代理程式載入器$ 服務。
您未在 [工作管理員] 中看到作為執行中處理序的 RdAgentBootLoader 元件。
您收到自定義映像 VM 上的「連線代理人無法驗證設定」錯誤。
本文中的先前區段無法解決您的問題。

步驟 1：解除安裝所有代理程式、開機載入器與堆疊元件程式

重新安裝代理程式、開機載入器與堆疊之前，您必須先從 VM 解除安裝任何現有的元件。解除安裝所有代理程式、開機載入器與堆疊元件程式：

以系統管理員身分登入工作階段主機 VM。
移至 [控制台> 程式>與功能]，或在 Windows 11 上，移至 [設定應用程式應用程式]。>
卸載下列程式，然後重新啟動您的工作階段主機 VM：

警告

卸載 遠端桌面服務 SxS 網路堆疊時，系統會提示您 關閉遠端桌面服務和遠端桌面服務 UserMode 埠重新導向器 。如果您使用 RDP 連線到工作階段主機 VM，請選取 [不要關閉應用程式]，然後選取 [ 確定]。否則，您的 RDP 連線將無法運作。
- 移除 Desktop Agent Boot Loader
- 移除 Desktop Services Infrastructure Agent
- 移除 Desktop Services Infrastructure Geneva Agent
- 移除 Desktop Services SxS Network Stack
注意

您可能會看到這些程式的多個實例。請務必移除所有程式。

步驟 2：從主機集區移除工作階段主機

當您從主機集區移除工作階段主機時，工作階段主機不會再向該主機集區註冊。這個變更可用於重設工作階段主機註冊。從主機集區移除工作階段主機：

登入 Azure 入口網站。
在搜尋列中輸入 Azure 虛擬桌面，並選取相符的服務項目。
選取 [主機集區]，然後選取工作階段主機 VM 所在的主機集區名稱。
選取 [工作階段主機]，以查看該主機集區中所有工作階段主機的清單。
查看工作階段主機的清單，然後勾選您所要移除工作階段主機旁的方塊。
選取 [移除]。

步驟 3：產生 VM 的新註冊金鑰

您必須產生新的註冊金鑰，用來將會話 VM 重新註冊到主機集區和服務。產生 VM 的新註冊金鑰：

登入 Azure 入口網站。
在搜尋列中輸入 Azure 虛擬桌面，並選取相符的服務項目。
選取 [主機集區]，然後選取工作階段主機 VM 所在的主機集區名稱。
在 [概觀] 刀鋒視窗中，選取 [註冊金鑰]。
開啟 [註冊金鑰] 索引標籤，然後選取 [產生新的金鑰]。
輸入到期日，然後選取 [ 確定]。

注意

到期日不能少於一小時，且自其產生時間與日期起不得超過 27 天。只有在您需要時才產生註冊金鑰。
將新產生的金鑰複製到剪貼簿或下載檔案。您稍後需要此金鑰。

步驟 4：重新安裝代理程式與開機載入器

重新安裝最新版的代理程式與開機載入器，也會自動安裝並存堆疊與日內瓦監視代理程式。要重新安裝代理程式與開機載入器，請遵循下列步驟。這是非驗證環境中可下載的 Azure 虛擬桌面代理程式最新版本。如需新版代理程式推出的詳細資訊，請參閱 Azure 虛擬桌面代理程式中的新增功能。

以系統管理員身分登入您的工作階段主機 VM，並執行工作階段主機 VM 的代理程式安裝程式和開機載入器：
- Azure 虛擬桌面代理程式
- Azure 虛擬桌面代理程式開機載入器
提示

針對您下載的每個代理程式和開機載入器安裝程式，您可能需要將其解除封鎖。以滑鼠右鍵按兩下每個檔案，然後選取 [屬性>解除封鎖>確定]。
當安裝程式要求您輸入註冊權杖時，請貼上剪貼簿中的註冊金鑰。
執行開機載入器安裝程式。
重新啟動工作階段 VM。
登入 Azure 入口網站。
在搜尋列中輸入「Azure 虛擬桌面」，並選取相符的服務項目。
選取 [主機集區]，然後選取工作階段主機 VM 所在的主機集區名稱。
選取 [工作階段主機]，以查看該主機集區中所有工作階段主機的清單。
您現在應該會看到已在主機集區中註冊的工作階段主機，其狀態為可用。

拿掉 DisableRegistryTools 登錄機碼

如果您已執行所有四個步驟，但代理程式仍然無法運作，可能是因為 DisableRegistryTools 登錄機碼已在下列其中一個位置啟用：

HKU： \DEFAULT\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
HKU： \S-1-5-18\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
HKCU： \SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1

此登錄機碼可防止代理程式安裝並存堆疊，這會導致 installMSIException 錯誤。此錯誤會導致工作階段主機卡在無法使用狀態。

若要解決此問題，您需要移除金鑰：

DisableRegistryTools從先前列出的三個位置移除索引鍵。
從應用程式和功能資料夾解除安裝並移除受影響的並存堆疊安裝。
移除受影響的並存堆疊登錄機碼。
重新啟動您的 VM。
啟動代理程式，讓它自動安裝並存堆疊。

下一步

若問題持續發生，請建立支援案例，並包含您所擁有問題的詳細資訊，以及您嘗試解決問題而採用的任何動作。下列清單包含可用於針對 Azure 虛擬桌面部署問題進行疑難排解的其他資源。

如需 Azure 虛擬桌面疑難排解與升級追蹤的概觀，請參閱疑難排解概觀、意見反應與支援。
若要針對在 Azure 虛擬桌面環境中建立主機集區時的問題進行疑難排解，請參閱環境和主機集區建立。
若要針對在 Azure 虛擬桌面中設定 VM 時的問題進行疑難解答，請參閱會話主機虛擬機設定。
若要針對 Azure 虛擬桌面用戶端連線的問題進行疑難排解，請參閱 Azure 虛擬桌面服務連線。
如要針對搭配 Azure 虛擬桌面使用 PowerShell 時的問題進行疑難排解，請參閱 Azure 虛擬桌面 PowerShell。
如要深入了解服務，請參閱 Azure 虛擬桌面環境。
若要完成疑難排解教學課程，請參閱教學課程: 針對 Resource Manager 範本部署進行疑難排解。
若要了解稽核動作，請參閱使用 Resource Manager 來稽核作業。
若要了解部署期間可採取哪些動作來判斷錯誤，請參閱檢視部署作業。

共用方式為

針對常見的 Azure 虛擬桌面代理程式問題進行疑難排解

錯誤：RDAgentBootLoader 和/或 Remote Desktop Agent Loader 已停止執行

錯誤：INVALID_REGISTRATION_TOKEN or EXPIRED_MACHINE_TOKEN

錯誤：代理程式無法使用 INVALID_FORM 連線至訊息代理程式

錯誤：3703

錯誤：3019

錯誤：InstallationHealthCheckFailedException

錯誤：ENDPOINT_NOT_FOUND

錯誤：InstallMsiException

錯誤：Win32Exception

錯誤：堆疊接聽程式無法在 Windows 10 2004 工作階段主機 VM 上運作

錯誤：DownloadMsiException

錯誤：代理程式無法使用 MissingMethodException 進行更新

錯誤：會話主機 VM 停滯在升級狀態

錯誤：工作階段主機卡在無法使用狀態

錯誤：工作階段主機停滯在「需要協助」狀態

UrlsAccessibleCheck

MetaDataServiceCheck

MonitoringAgentCheck

錯誤：找不到連線：RDAgent 沒有與訊息代理程式的作用中連線

錯誤：操作 Pro VM 或其他不支援的 OS

錯誤：NAME_ALREADY_REGISTERED

您的問題未列在此處或未解決

步驟 1：解除安裝所有代理程式、開機載入器與堆疊元件程式

步驟 2：從主機集區移除工作階段主機

步驟 3：產生 VM 的新註冊金鑰

步驟 4：重新安裝代理程式與開機載入器

拿掉 DisableRegistryTools 登錄機碼

下一步

意見反應

其他資源