Troubleshooting overview, feedback, and support for Azure Virtual Desktop

Important

This content applies to Azure Virtual Desktop with Azure Resource Manager Azure Virtual Desktop objects. If you're using Azure Virtual Desktop (classic) without Azure Resource Manager objects, see this article.

This article provides an overview of the issues you may encounter when setting up an Azure Virtual Desktop environment and provides ways to resolve the issues.

Troubleshoot deployment and connection issues

Azure Virtual Desktop Insights is a dashboard built on Azure Monitor workbooks that can quickly troubleshoot and identify issues in your Azure Virtual Desktop environment for you. If you prefer working with Kusto queries, we recommend using the built-in diagnostic feature, Log Analytics, instead.

Report issues

To report issues or suggest features for Azure Virtual Desktop with Azure Resource Manager integration, visit the Azure Virtual Desktop Tech Community. You can use the Tech Community to discuss best practices or suggest and vote for new features.

When you make a post asking for help or propose a new feature, make sure you describe your topic in as much detail as possible. Detailed information can help other users answer your question or understand the feature you're proposing a vote for.

Help with application issues

If you encounter issues with your applications running in Azure Virtual Desktop, App Assure is a service from Microsoft designed to help you resolve them at no additional cost. For more information, go to App Assure.

Escalation tracks

Before doing anything else, make sure to check the Azure status page and Azure Service Health to make sure your Azure service is running properly.

Use the following table to identify and resolve issues you may encounter when setting up an environment using Remote Desktop client. Once your environment's set up, you can use our new Diagnostics service to identify issues for common scenarios.

Issue Suggested Solution
Session host pool Azure Virtual Network (VNET) and Express Route settings Open an Azure support request, then select the appropriate service (under the Networking category).
Session host pool Virtual Machine (VM) creation when Azure Resource Manager templates provided with Azure Virtual Desktop aren't being used Open an Azure support request, then select Azure Virtual Desktop for the service.

For issues with the Azure Resource Manager templates that are provided with Azure Virtual Desktop, see Azure Resource Manager template errors section of Host pool creation.
Managing Azure Virtual Desktop session host environment from the Azure portal Open an Azure support request.

For management issues when using Remote Desktop Services/Azure Virtual Desktop PowerShell, see Azure Virtual Desktop PowerShell or open an Azure support request, select Azure Virtual Desktop for the service, select Configuration and management for the problem type, then select Issues configuring environment using PowerShell for the problem subtype.
Managing Azure Virtual Desktop configuration tied to host pools and application groups (app groups) See Azure Virtual Desktop PowerShell, or open an Azure support request, select Azure Virtual Desktop for the service, then select the appropriate problem type.
Deploying and manage FSLogix Profile Containers See Troubleshooting guide for FSLogix products and if that doesn't resolve the issue, Open an Azure support request, select Azure Virtual Desktop for the service, select FSLogix for the problem type, then select the appropriate problem subtype.
Remote desktop clients malfunction on start See Troubleshoot the Remote Desktop client and if that doesn't resolve the issue, Open an Azure support request, select Azure Virtual Desktop for the service, then select Remote Desktop clients for the problem type.

If it's a network issue, your users need to contact their network administrator.
Connected but no feed Troubleshoot using the User connects but nothing is displayed (no feed) section of Azure Virtual Desktop service connections.

If your users have been assigned to an application group, open an Azure support request, select Azure Virtual Desktop for the service, then select Remote Desktop Clients for the problem type.
Feed discovery problems due to the network Your users need to contact their network administrator.
Connecting clients See Azure Virtual Desktop service connections and if that doesn't solve your issue, see Session host virtual machine configuration.
Responsiveness of desktops or applications If issues are tied to a specific application or product, contact the team responsible for that product.
Licensing messages or errors If issues are tied to a specific application or product, contact the team responsible for that product.
Issues with third-party authentication methods or tools Verify that your third-party provider supports Azure Virtual Desktop scenarios and approach them regarding any known issues.
Issues using Log Analytics for Azure Virtual Desktop For issues with the diagnostics schema, open an Azure support request.

For queries, visualization, or other issues in Log Analytics, select the appropriate problem type under Log Analytics.
Issues using Microsoft 365 apps Contact the Microsoft 365 admin center with one of the Microsoft 365 admin center help options.

Next steps