Skip to content

Commit be82087

Browse files
committed
Adding new section.
1 parent c47fe32 commit be82087

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

articles/virtual-desktop/troubleshoot-agent.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -371,6 +371,24 @@ By reinstalling the most updated version of the agent and boot loader, the side-
371371
> [!div class="mx-imgBorder"]
372372
> ![Screenshot of available session host](media/hostpool-portal.png)
373373
374+
## Remove DisableRegistryTools
375+
376+
If you've performed all four steps but the agent still doesn't work, that may be because the DisableRegistryTools registry key is enabled in one of the following locations:
377+
378+
- HKU:\DEFAULT\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
379+
- HKU:\S-1-5-18\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
380+
- HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
381+
382+
This registry key prevents the agent from installing the side-by-side stack, which results in an installMSIException error. This error leads to the session hosts being stuck in an unavailable state.
383+
384+
To resolve this issue, you'll need to remove the key:
385+
386+
1. Remove the DisableRegistryTools key from the three previously listed locations.
387+
2. Uninstall and remove the affected side-by-side stack installation from the **Apps & Features** folder.
388+
3. Remove the affected side-by-side stack's registry keys.
389+
4. Restart your VM.
390+
5. Start the agent and let it auto-install the side-by-side stack.
391+
374392
## Next steps
375393

376394
If the issue continues, create a support case and include detailed information about the problem you're having and any actions you've taken to try to resolve it. The following list includes other resources you can use to troubleshoot issues in your Azure Virtual Desktop deployment.

0 commit comments

Comments
 (0)