Skip to content

Commit b412ccd

Browse files
Merge pull request #235709 from dknappettmsft/avd-remove--old-script-links
AVD removed old script links
2 parents 42628e3 + b595d06 commit b412ccd

File tree

1 file changed

+21
-54
lines changed

1 file changed

+21
-54
lines changed

articles/virtual-desktop/troubleshoot-vm-configuration.md

Lines changed: 21 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -172,8 +172,6 @@ When the Azure Virtual Desktop Agent is first installed on session host VMs (eit
172172
173173
## Troubleshooting issues with the Azure Virtual Desktop side-by-side stack
174174
175-
The Azure Virtual Desktop side-by-side stack is automatically installed with Windows Server 2019 and newer. Use Microsoft Installer (MSI) to install the side-by-side stack on Microsoft Windows Server 2016 or Windows Server 2012 R2. For Microsoft Windows 10, the Azure Virtual Desktop side-by-side stack is enabled with **enablesxstackrs.ps1**.
176-
177175
There are three main ways the side-by-side stack gets installed or enabled on session host pool VMs:
178176
179177
- With the Azure portal creation template
@@ -187,7 +185,7 @@ The output of **qwinsta** will list **rdp-sxs** in the output if the side-by-sid
187185
> [!div class="mx-imgBorder"]
188186
> ![Side-by-side stack installed or enabled with qwinsta listed as rdp-sxs in the output.](media/23b8e5f525bb4e24494ab7f159fa6b62.png)
189187
190-
Examine the registry entries listed below and confirm that their values match. If registry keys are missing or values are mismatched, make sure you're running [a supported operating system](troubleshoot-agent.md#error-operating-a-pro-vm-or-other-unsupported-os). If you are, follow the instructions in [Create a host pool with PowerShell](create-host-pools-powershell.md) on how to reinstall the side-by-side stack.
188+
Examine the registry entries listed below and confirm that their values match. If registry keys are missing or values are mismatched, make sure you're running [a supported operating system](troubleshoot-agent.md#error-operating-a-pro-vm-or-other-unsupported-os). If you are, follow the instructions in [Register session hosts to a host pool](add-session-hosts-host-pool.md#register-session-hosts-to-a-host-pool) for how to reinstall the side-by-side stack.
191189
192190
```registry
193191
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal
@@ -207,7 +205,7 @@ Examine the registry entries listed below and confirm that their values match. I
207205
**Fix:** Follow these instructions to install the side-by-side stack on the session host VM.
208206

209207
1. Use Remote Desktop Protocol (RDP) to get directly into the session host VM as local administrator.
210-
2. Install the side-by-side stack using [Create a host pool with PowerShell](create-host-pools-powershell.md).
208+
2. Install the side-by-side stack by following the steps to [Register session hosts to a host pool](add-session-hosts-host-pool.md#register-session-hosts-to-a-host-pool).
211209

212210
## How to fix an Azure Virtual Desktop side-by-side stack that malfunctions
213211

@@ -216,80 +214,49 @@ There are known circumstances that can cause the side-by-side stack to malfuncti
216214
- Not following the correct order of the steps to enable the side-by-side stack
217215
- Auto update to Windows 10 Enhanced Versatile Disc (EVD)
218216
- Missing the Remote Desktop Session Host (RDSH) role
219-
- Running enablesxsstackrc.ps1 multiple times
220-
- Running enablesxsstackrc.ps1 in an account that doesn't have local admin privileges
221217

222-
The instructions in this section can help you uninstall the Azure Virtual Desktop side-by-side stack. Once you uninstall the side-by-side stack, go to "Register the VM with the Azure Virtual Desktop host pool" in [Create a host pool with PowerShell](create-host-pools-powershell.md) to reinstall the side-by-side stack.
218+
The instructions in this section can help you uninstall the Azure Virtual Desktop side-by-side stack. Once you uninstall the side-by-side stack, follow the steps to [Register session hosts to a host pool](add-session-hosts-host-pool.md#register-session-hosts-to-a-host-pool) to reinstall the side-by-side stack.
223219

224220
The VM used to run remediation must be on the same subnet and domain as the VM with the malfunctioning side-by-side stack.
225221

226222
Follow these instructions to run remediation from the same subnet and domain:
227223

228224
1. Connect with standard Remote Desktop Protocol (RDP) to the VM from where fix will be applied.
229-
2. Download PsExec from [PsExec v2.40](/sysinternals/downloads/psexec).
230-
3. Unzip the downloaded file.
231-
4. Start command prompt as local administrator.
232-
5. Navigate to folder where PsExec was unzipped.
233-
6. From command prompt, use the following command:
234-
235-
```cmd
236-
psexec.exe \\<VMname> cmd
237-
```
238-
239-
>[!NOTE]
240-
>VMname is the machine name of the VM with the malfunctioning side-by-side stack.
241-
242-
7. Accept the PsExec License Agreement by clicking Agree.
243-
244-
> [!div class="mx-imgBorder"]
245-
> ![Software license agreement screenshot.](media/SoftwareLicenseTerms.png)
246-
247-
>[!NOTE]
248-
>This dialog will show up only the first time PsExec is run.
249225

250-
8. After the command prompt session opens on the VM with the malfunctioning side-by-side stack, run qwinsta and confirm that an entry named rdp-sxs is available. If not, a side-by-side stack isn't present on the VM so the issue isn't tied to the side-by-side stack.
226+
1. [Download and install PsExec](/sysinternals/downloads/psexec).
251227

252-
> [!div class="mx-imgBorder"]
253-
> ![Administrator command prompt](media/AdministratorCommandPrompt.png)
254-
255-
9. Run the following command, which will list Microsoft components installed on the VM with the malfunctioning side-by-side stack.
256-
257-
```cmd
258-
wmic product get name
259-
```
228+
1. Start command prompt as local administrator, then navigate to folder where PsExec was unzipped.
260229

261-
10. Run the command below with product names from step above.
230+
1. From command prompt, use the following command, where `<VMname>` is the hostname name of the VM with the malfunctioning side-by-side stack. If this is the first time you have run PsExec, you'll also need to accept the PsExec License Agreement to continue by clicking **Agree**.
262231

263232
```cmd
264-
wmic product where name="<Remote Desktop Services Infrastructure Agent>" call uninstall
233+
psexec.exe \\<VMname> cmd
265234
```
266235
267-
11. Uninstall all products that start with "Remote Desktop."
236+
1. After the command prompt session opens on the VM with the malfunctioning side-by-side stack, run the following command and confirm that an entry named rdp-sxs is available. If not, a side-by-side stack isn't present on the VM so the issue isn't tied to the side-by-side stack.
268237
269-
12. After all Azure Virtual Desktop components have been uninstalled, follow the instructions for your operating system:
238+
```cmd
239+
qwinsta
240+
```
270241

271-
13. If your operating system is Windows Server, restart the VM that had the malfunctioning side-by-side stack (either with Azure portal or from the PsExec tool).
242+
> [!div class="mx-imgBorder"]
243+
> ![Administrator command prompt](media/AdministratorCommandPrompt.png)
272244
273-
If your operating system is Microsoft Windows 10, continue with the instructions below:
274-
275-
14. From the VM running PsExec, open File Explorer and copy disablesxsstackrc.ps1 to the system drive of the VM with the malfunctioned side-by-side stack.
245+
1. Run the following command, which will list Microsoft components installed on the VM with the malfunctioning side-by-side stack.
276246

277247
```cmd
278-
\\<VMname>\c$\
248+
wmic product get name
279249
```
280250
281-
>[!NOTE]
282-
>VMname is the machine name of the VM with the malfunctioning side-by-side stack.
283-
284-
15. The recommended process: from the PsExec tool, start PowerShell and navigate to the folder from the previous step and run disablesxsstackrc.ps1. Alternatively, you can run the following cmdlets:
251+
1. Run the command below with product names from step above, for example:
285252
286-
```PowerShell
287-
Remove-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server\ClusterSettings" -Name "SessionDirectoryListener" -Force
288-
Remove-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\rdp-sxs" -Recurse -Force
289-
Remove-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations" -Name "ReverseConnectionListener" -Force
253+
```cmd
254+
wmic product where name="<Remote Desktop Services Infrastructure Agent>" call uninstall
290255
```
291256
292-
16. When the cmdlets are done running, restart the VM with the malfunctioning side-by-side stack.
257+
1. Uninstall all products that start with **Remote Desktop**.
258+
259+
1. After all Azure Virtual Desktop components have been uninstalled, restart the VM that had the malfunctioning side-by-side stack (either with Azure portal or from the PsExec tool). You can then reinstall the side-by-side stack by following the steps to [Register session hosts to a host pool](add-session-hosts-host-pool.md#register-session-hosts-to-a-host-pool).
293260
294261
## Remote Desktop licensing mode isn't configured
295262

0 commit comments

Comments
 (0)