Skip to content

Commit 3064486

Browse files
Merge pull request #9801 from rocolem/docs-editor/troubleshoot-agent-1759247025
AB#7933: Req pub live date =<10/10/25 | Update troubleshoot-agent.md
2 parents 8deb4c5 + 30a2ecf commit 3064486

File tree

1 file changed

+65
-0
lines changed

1 file changed

+65
-0
lines changed

support/azure/virtual-desktop/troubleshoot-agent.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -315,6 +315,71 @@ To resolve this issue:
315315

316316
:::image type="content" source="media/troubleshoot-agent/hostpool-portal.png" alt-text="Screenshot of available session host.":::
317317

318+
## Error: RDAgentBootLoader startup timeouts at OS boot
319+
320+
If any of the following issues occur, the Remote Desktop Agent Boot Loader (RDAgentBootLoader) service is not starting fast enough at OS boot. This can make the session host appear unhealthy and block user connections:
321+
322+
- RDAgentBootLoader is either stopped or not running.
323+
- The session host status shows **Needs assistance** or **Unavailable**.
324+
- Users can't connect when using start on connect.
325+
- The Windows Service Control Manager logs service start timeouts, such as Event 7000 or Event 7011.
326+
327+
To resolve this issue, try the following steps:
328+
329+
### Set RDAgentBootLoader to Automatic (Delayed Start)
330+
331+
This defers the service startup until after initial boot pressure subsides.
332+
333+
1. Open **Services** (services.msc).
334+
2. Locate **Remote Desktop Agent Loader**.
335+
3. Right-click the service and select **Properties**.
336+
4. Set **Startup type** to **Automatic (Delayed Start)**.
337+
5. Select **Apply**, then **OK**.
338+
339+
### Increase the service startup timeout
340+
341+
This gives Windows more time to report the service as running.
342+
343+
1. Open Command Prompt as administrator.
344+
2. Run the following command:
345+
346+
```command
347+
reg add "HKLM\SYSTEM\CurrentControlSet\Control" /v ServicesPipeTimeout /t REG_DWORD /d 60000 /f
348+
```
349+
> [!TIP]
350+
> Start with 60,000 ms (60s) and tune as needed. A reboot is required.
351+
352+
### Verify boot performance
353+
354+
Ensure the VM meets recommended IOPS and that image startup tasks (such as antivirus scans, heavy logon scripts, or large GPOs) aren't starving the agent at boot.
355+
356+
### Validate required service endpoints
357+
358+
If the host still shows **Needs assistance** or **Unavailable**, run **WVDAgentUrlTool.exe** and remediate any failing endpoints. For more information, see this [article](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-desktop/agent-connectivity#check-access-to-required-fqdns-and-endpoints).
359+
360+
### Verification
361+
362+
- Reboot the session host.
363+
- Confirm the host transitions to **Available** within a few minutes of boot.
364+
- Review **Event Viewer** to ensure no new service start timeouts appear.
365+
366+
### Next steps
367+
368+
If issues persist, review registration token health and duplicate host entries.
369+
370+
### Recover from duplicate or expired registration
371+
372+
Applies to: Errors such as **NAME_ALREADY_REGISTERED**, **EXPIRED_MACHINE**, or Event 3277.
373+
374+
1. In the Azure portal, open the host pool and remove any duplicate or stale entries for the affected session host.
375+
2. Generate a new registration key for the host pool.
376+
3. On the session host, uninstall the Azure Virtual Desktop Agent and Remote Desktop Agent Loader (BootLoader).
377+
4. Reinstall the latest Agent and BootLoader packages.
378+
5. Re-register the session host using the new registration key.
379+
6. Verify the host reports **Available** and accepts connections.
380+
381+
If that is unsuccessful, complete a clean reinstall of the Agent and Bootloader following the guidance [here](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-desktop/troubleshoot-agent#step-4-reinstall-the-agent-and-boot-loader).
382+
318383
## Your issue isn't listed here or wasn't resolved
319384

320385
If you can't find your issue in this article or the instructions didn't help you, we recommend you uninstall, reinstall, and re-register the Azure Virtual Desktop Agent. The instructions in this section show you how to reregister your session host VM to the Azure Virtual Desktop service by:

0 commit comments

Comments
 (0)