You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/virtual-desktop/troubleshoot-vm-configuration.md
+21-54Lines changed: 21 additions & 54 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -172,8 +172,6 @@ When the Azure Virtual Desktop Agent is first installed on session host VMs (eit
172
172
173
173
## Troubleshooting issues with the Azure Virtual Desktop side-by-side stack
174
174
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
-
177
175
There are three main ways the side-by-side stack gets installed or enabled on session host pool VMs:
178
176
179
177
- 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
187
185
> [!div class="mx-imgBorder"]
188
186
> 
189
187
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.
@@ -207,7 +205,7 @@ Examine the registry entries listed below and confirm that their values match. I
207
205
**Fix:** Follow these instructions to install the side-by-side stack on the session host VM.
208
206
209
207
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).
211
209
212
210
## How to fix an Azure Virtual Desktop side-by-side stack that malfunctions
213
211
@@ -216,80 +214,49 @@ There are known circumstances that can cause the side-by-side stack to malfuncti
216
214
- Not following the correct order of the steps to enable the side-by-side stack
217
215
- Auto update to Windows 10 Enhanced Versatile Disc (EVD)
218
216
- 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
221
217
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.
223
219
224
220
The VM used to run remediation must be on the same subnet and domain as the VM with the malfunctioning side-by-side stack.
225
221
226
222
Follow these instructions to run remediation from the same subnet and domain:
227
223
228
224
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.
>This dialog will show up only the first time PsExec is run.
249
225
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).
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.
260
229
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**.
262
231
263
232
```cmd
264
-
wmic product where name="<Remote Desktop Services Infrastructure Agent>" call uninstall
233
+
psexec.exe \\<VMname> cmd
265
234
```
266
235
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.
268
237
269
-
12. After all Azure Virtual Desktop components have been uninstalled, follow the instructions for your operating system:
238
+
```cmd
239
+
qwinsta
240
+
```
270
241
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).
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.
276
246
277
247
```cmd
278
-
\\<VMname>\c$\
248
+
wmic product get name
279
249
```
280
250
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:
wmic product where name="<Remote Desktop Services Infrastructure Agent>" call uninstall
290
255
```
291
256
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).
0 commit comments