1# VM Agent Not Responding
2 
3Run Command and password reset depend on the VM agent. If the agent is unhealthy, alternative methods are needed.
4 
5> ⚠️ **OS Note:** Serial Console, Boot Diagnostics, and repair VM commands are available for both Windows and Linux but use separate doc pages and tools. Match the correct OS below.
6 
7## Symptoms → Solutions
8 
9| Symptom                                                          | OS      | Solution                                                 | Documentation                                                                                                                                                       |
10| ---------------------------------------------------------------- | ------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
11| Run Command times out                                            | Windows | VM agent may be down — use Serial Console instead        | [Serial Console — Windows](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/windows/serial-console-overview)                                   |
12| Run Command times out                                            | Linux   | VM agent may be down — use Serial Console instead        | [Serial Console — Linux](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/serial-console-linux)                                         |
13| Password reset fails via Portal/CLI                              | Windows | VMAccess extension can't communicate — use offline reset | [Reset password without agent](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/windows/reset-local-password-without-agent)                    |
14| Password/key reset fails via Portal/CLI                          | Linux   | VMAccess extension can't communicate — use Serial Console | [Serial Console — Linux](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/serial-console-linux)                                        |
15| VM not booting (Boot Diagnostics shows BSOD/stuck)               | Windows | OS-level issue — use repair VM for offline fix           | [Repair Windows VM](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/windows/repair-windows-vm-using-azure-virtual-machine-repair-commands)    |
16| VM not booting (Boot Diagnostics shows kernel panic/stuck)       | Linux   | Use repair VM for offline Linux disk fix                 | [Repair Linux VM](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/repair-linux-vm-using-azure-virtual-machine-repair-commands)          |
17| VMAccess extension error on domain controller                    | Windows | VMAccess doesn't support DCs — use Serial Console        | [Serial Console — Windows](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/windows/serial-console-overview)                                   |
18 
19## Quick Commands
20 
21```bash
22# Connect to Serial Console via CLI
23az serial-console connect --name <vm-name> -g <resource-group>
24 
25# Enable boot diagnostics (required for Serial Console)
26az vm boot-diagnostics enable --name <vm-name> -g <resource-group>
27 
28# Get boot diagnostics screenshot/log
29az vm boot-diagnostics get-boot-log --name <vm-name> -g <resource-group>
30 
31# Create repair VM for offline fixes
32az vm repair create --name <vm-name> -g <resource-group> \
33  --repair-username repairadmin --repair-password '<password>'
34 
35# Restore after offline fix
36az vm repair restore --name <vm-name> -g <resource-group>
37```
38