Skip to content

6. Troubleshooting Quick Reference

Jump to bottom
Brandon McMillan edited this page Mar 27, 2026 · 5 revisions

Troubleshooting Quick Reference

Common AVD issues and solutions. For detailed help, see Microsoft documentation.

Quick Checks

Azure Portal:

  • AVD Insights → Health status
  • Diagnostics → Review logs
  • Service Health → Check outages
  • Activity Log → Recent changes

PowerShell:

# Session host status
Get-AzWvdSessionHost -HostPoolName <pool> -ResourceGroupName <rg>

# Network test
Test-NetConnection -ComputerName <host> -Port 3389

# Agent health
Get-Service RDAgentBootLoader, RDAgent

Connection Issues

Users Cannot Connect:

Cause Solution
No app group assigned Assign user to application group
Session host off Start VMs, check drain mode
Network blocked Allow required URLs
Token expired Generate new registration token
Agent down Restart RDAgent services 
# Assign user
New-AzRoleAssignment -SignInName user@domain.com -RoleDefinitionName \"Desktop Virtualization User\" -ResourceName <AppGroup> -ResourceGroupName <RG> -ResourceType Microsoft.DesktopVirtualization/applicationGroups

# Restart services
Restart-Service RDAgentBootLoader, RDAgent

Slow Performance:

  • Check bandwidth (1.5 Mbps minimum per user)
  • Enable RDP Shortpath (UDP)
  • Review CPU/memory on session hosts
  • Connect to nearby region

Authentication Issues

SSO Not Working:

  • Check Azure AD join status: dsregcmd /status
  • Verify FSLogix Entra ID integration
  • Review Conditional Access policies

MFA Problems:

  • Configure Conditional Access for AVD
  • Enable "Remember MFA on trusted devices"

Profile Issues (FSLogix)

Profile Won't Load:

Issue Solution
Network path not accessible Test: net use \\\\server\\share
Permissions missing Add user modify rights to share
Profile corrupted Delete/rebuild user's VHD
Disk full Increase storage quota
VHD locked Log off user from all sessions

Registry Check:

Get-ItemProperty -Path \"HKLM:\\SOFTWARE\\FSLogix\\Profiles\"
# Enabled = 1
# VHDLocations = \\\\server\\share

Session Host Issues

Host Unavailable:

  1. Check VM is running
  2. Verify AVD agent running
  3. Check registration token
  4. Review diagnostic logs

Re-register Host:

# Get new token
$token = New-AzWvdRegistrationInfo -ResourceGroupName <RG> -HostPoolName <pool> -ExpirationTime (Get-Date).AddDays(1)

# Install agent
msiexec /i \"AVDAgentInstaller.msi\" /quiet REGISTRATIONTOKEN=$token

Drain Mode:

# Check status
Get-AzWvdSessionHost -HostPoolName <pool> -ResourceGroupName <RG> | Select Name, AllowNewSession

# Enable connections
Update-AzWvdSessionHost -HostPoolName <pool> -ResourceGroupName <RG> -Name <host> -AllowNewSession:$true

MSIX App Attach Issues

Package Not Appearing:

  • Check package registered on host pool
  • Verify user permissions to CIM/VHD file
  • Ensure certificate trusted on session hosts
  • Check event logs: Get-WinEvent -LogName \"Microsoft-Windows-AppXDeployment/Operational\"

Common Errors:

  • 0x80073CF0: Package conflict
  • 0x80073D02: Certificate not trusted

Autoscale Issues

Hosts Not Starting/Stopping:

  • Verify scaling plan assigned to host pool
  • Check service principal permissions
  • Review time zone settings
  • Confirm schedules configured

Required Permissions:

  • Desktop Virtualization Power On Off Contributor
  • Desktop Virtualization Contributor (host pool)

Network Requirements

Essential URLs:

*.wvd.microsoft.com
*.servicebus.windows.net
*.prod.warm.ingest.monitor.core.windows.net
catalogartifact.azureedge.net

Full URL list

Monitoring Logs

Log Analytics KQL:

// Connection failures
WVDConnections 
| where State == \"Failed\"
| project TimeGenerated, UserName, ClientOS

// Session host health
WVDAgentHealthStatus
| where Status != \"Available\"
| project TimeGenerated, SessionHostName, Status

Event Viewer (Session Host):

  • TerminalServices-* logs
  • FSLogix → Apps/Profiles

Common Error Codes

Code Meaning Solution
0x204 No resources Check app group assignments
0x3 Host unavailable Start VMs, check agent
0x30D Certificate error Update RD certificate
0x80078010 Profile error Check FSLogix config

Additional Help

Still stuck? Check Azure Status or open a support ticket. 3. Check MFA policies aren't conflicting 4. Verify network location conditions

Reference: Enforce MFA for AVD

FSLogix Profile Issues

Profile Fails to Load:

Common Causes:

Issue Diagnostic Solution
Network path inaccessible Test access: net use \\server\share Check permissions, SMB, firewall
Insufficient permissions Check NTFS + Share permissions Add user to profile share with modify rights
Corrupted profile Check Event Viewer: FSLogix logs Delete/rebuild user's VHD/VHDX
Disk full Check storage account or file share capacity Increase quota or clean old profiles
VHD locked Check if profile is mounted elsewhere Log user off all sessions, unmount VHD

FSLogix Registry Keys to Check:

# On session host
Get-ItemProperty -Path "HKLM:\SOFTWARE\FSLogix\Profiles"

# Key settings:
# Enabled = 1
# VHDLocations = \\server\share
# DeleteLocalProfileWhenVHDShouldApply = 1

Profile Disk Growing Too Large:

  1. Enable OneDrive Known Folder Move for documents
  2. Exclude temporary folders with FSLogix rules
  3. Implement profile disk clean-up scripts
  4. Use Cloud Cache for write-back optimization

Shrink Profile Script:

Session Host Issues

Hosts Showing "Unavailable":

  1. Check VM is running in Azure Portal
  2. Verify AVD agent is running
  3. Check registration token validity
  4. Review VM diagnostics logs

Solutions:

# Re-register session host (run on the host)
$token = "<NewRegistrationToken>"
msiexec /i "C:\AVDAgent\AVDAgentInstaller.msi" /quiet REGISTRATIONTOKEN=$token

# Or use PowerShell to generate new token
$token = New-AzWvdRegistrationInfo -ResourceGroupName <RG> -HostPoolName <pool> -ExpirationTime (Get-Date).AddDays(1)

Session Host Won't Accept Connections (Drain Mode):

# Check drain mode status
Get-AzWvdSessionHost -HostPoolName <pool> -ResourceGroupName <RG> | Select Name, AllowNewSession

# Disable drain mode
Update-AzWvdSessionHost -HostPoolName <pool> -ResourceGroupName <RG> -Name <host> -AllowNewSession:$true

App Attach / MSIX Issues

MSIX Package Not Appearing:

  • Package registered on host pool
  • Package staged correctly
  • User has permissions to access .CIM/.VHD file
  • Certificate installed and trusted on session hosts
  • Package targets correct application group

Verification:

# Check MSIX packages
Get-AppxPackage -AllUsers

# View Event Viewer logs
Get-WinEvent -LogName "Microsoft-Windows-AppXDeployment/Operational" -MaxEvents 50

Common Errors:

  • 0x80073CF0: Package conflicts with existing installation
  • 0x80073D02: Certificate not trusted - install cert in Trusted People store

Autoscale Issues

Hosts Not Starting/Stopping:

  1. Scaling plan is assigned to host pool
  2. Start VM on Connect is configured (if using)
  3. Service principal has correct permissions
  4. Schedules are configured correctly
  5. Time zones are accurate

Required Permissions for Autoscale:

  • Desktop Virtualization Power On Off Contributor
  • Desktop Virtualization Contributor (on host pool)

Review Autoscale Activity:

# Check last scaling operation
Get-AzOperationalInsightsQuery -WorkspaceId <workspace> -Query 'WVDAutoscaleEvaluationPooled | where TimeGenerated > ago(24h)'

Reference: Autoscale Diagnostics

Network & Firewall

Required URLs Not Accessible:

*.wvd.microsoft.com
*.servicebus.windows.net
*.prod.warm.ingest.monitor.core.windows.net
catalogartifact.azureedge.net
kms.core.windows.net

Test Connectivity:

# Test required endpoints
Test-NetConnection -ComputerName prod.warm.ingest.monitor.core.windows.net -Port 443

Full List: Required URL List

UDP Ports for RDP Shortpath:

Monitoring & Logs

Where to Find Logs:

// Connection failures
WVDConnections 
| where State == "Failed"
| project TimeGenerated, UserName, ClientOS, ClientSideError
| order by TimeGenerated desc

// Session host health
WVDAgentHealthStatus
| where Status != "Available"
| project TimeGenerated, SessionHostName, Status, StatusDetails

// Performance issues
Perf 
| where ObjectName == "Processor" and CounterName == "% Processor Time"
| summarize avg(CounterValue) by Computer
| where avg_CounterValue > 80

Event Viewer (Session Host):

  • Application and Services Logs → Microsoft → Windows → TerminalServices-*
  • FSLogix → Apps / Profiles

Enable Diagnostics:

Enable diagnostics for host pool

New-AzDiagnosticSetting -ResourceId <HostPoolResourceId> -WorkspaceId <LogAnalyticsWorkspaceId> -Enabled $true

Common Error Codes

Error Code Meaning Solution
0x204 No resources available Check app group assignments
0x3 Session host unavailable Verify VMs are running and agent healthy
0x30D Certificate error Update or trust RD certificate
0x80078010 Profile service error Check FSLogix configuration
0x1000007 Agent not ready Reinstall AVD agent

Additional Resources

Official Troubleshooting Guides:

Community Resources:

Tools:

Still Stuck?

  1. Check Service Health: Azure Status Page
  2. Review Recent Changes: Azure Activity Logs
  3. Community Support: Tech Community Forum
  4. Open Support Ticket: Azure Portal → Support + Troubleshooting
  5. Emergency: Microsoft Premier Support or Unified Support

Clone this wiki locally