azure-virtual-desktop

name	azure-virtual-desktop
description	Expert knowledge for Azure Virtual Desktop development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing AVD host pools, autoscale, FSLogix profiles, MSIX App Attach apps, or Teams optimization, and other Azure Virtual Desktop related development tasks. Not for Azure Virtual Machines (use azure-virtual-machines), Azure Dev Box (use azure-dev-box), Azure VMware Solution (use azure-vmware-solution).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

Azure Virtual Desktop Skill

This skill provides expert guidance for Azure Virtual Desktop. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L53	Diagnosing and fixing AVD issues: agent updates, autoscale, connectivity, session host health, graphics/Teams performance, MSIX App Attach, and using logs/Insights for troubleshooting.
Best Practices	L54-L64	Best practices for autoscaling, host pool validation, proxy usage, Start VM on Connect, Windows multi-session configuration, and resolving Azure Advisor/FAQ guidance for Azure Virtual Desktop.
Decision Making	L65-L79	Guidance on planning and choosing AVD deployment models, autoscale, host pool and session host management, storage, data locations, licensing, costs, ESU, and extended/local zones.
Architecture & Design Patterns	L80-L87	Design patterns for AVD app delivery, stateless hosts, DR, FSLogix profile containers, and automated scaling with Automation/Logic Apps.
Limits & Quotas	L88-L93	Guidance on RDP bandwidth requirements and optimizing Microsoft Teams (audio/video, collaboration features) performance and configuration in Azure Virtual Desktop.
Security	L94-L115	Securing AVD access and sessions: SSO (Entra ID/AD FS/Kerberos), Conditional Access/MFA, RBAC and delegated admin, clipboard/screen/watermark controls, external identities, and Purview forensic onboarding.
Configuration	L116-L175	Configuring AVD environments: images, autoscale, networking, RDP/peripheral redirection, Teams/Office, licensing, monitoring, and client/host settings for performance and user experience.
Integrations & Coding Patterns	L176-L182	Managing AVD via CLI/PowerShell, integrating partner App Attach delivery, enabling WebRTC multimedia redirection, and launching resources using custom URI schemes.
Deployment	L183-L192	Guides for deploying and migrating AVD: adding session hosts, moving from classic, hybrid/on-prem setups, regional host pools, region moves, and client/MMR deployment via Intune/ConfigMgr.

Troubleshooting

Topic	URL
Monitor and troubleshoot AVD agent updates with logs	https://learn.microsoft.com/en-us/azure/virtual-desktop/agent-updates-diagnostics
Test and troubleshoot MSIX packages for App Attach	https://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-test-msix-packages
Monitor and troubleshoot Azure Virtual Desktop autoscale with Insights	https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-monitor-operations-insights
Validate Azure Virtual Desktop FQDN and endpoint connectivity	https://learn.microsoft.com/en-us/azure/virtual-desktop/check-access-validate-required-fqdn-endpoint
Analyze and troubleshoot AVD connection quality	https://learn.microsoft.com/en-us/azure/virtual-desktop/connection-latency
Collect and query AVD connection quality logs	https://learn.microsoft.com/en-us/azure/virtual-desktop/connection-quality-monitoring
Use diagnostics and Log Analytics for AVD issues	https://learn.microsoft.com/en-us/azure/virtual-desktop/diagnostics-log-analytics
Diagnose graphics performance issues with RemoteFX counters	https://learn.microsoft.com/en-us/azure/virtual-desktop/remotefx-graphics-performance-counters
Interpret AVD session host statuses and health checks	https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-status-health-checks
Interpret AVD session host statuses and health checks	https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-status-health-checks

Best Practices

Topic	URL
Apply autoscale best practices for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-faq
Resolve Azure Advisor recommendations for AVD	https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-advisor-recommendations
Configure Azure Virtual Desktop validation host pools	https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-validation-environment
Apply Azure Virtual Desktop FAQ best practices	https://learn.microsoft.com/en-us/azure/virtual-desktop/faq
Apply proxy server guidelines for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/proxy-server-support
Start VM on Connect FAQ and usage best practices	https://learn.microsoft.com/en-us/azure/virtual-desktop/start-virtual-machine-connect-faq
Apply best practices for Windows Enterprise multi-session	https://learn.microsoft.com/en-us/azure/virtual-desktop/windows-multisession-faq

Decision Making

Topic	URL
Choose and tune Azure Virtual Desktop autoscale plans	https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-scenarios
Use Azure Extended Zones with Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-extended-zones
Plan Azure Virtual Desktop on Azure Local	https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-local-overview
Understand Azure Virtual Desktop data locations	https://learn.microsoft.com/en-us/azure/virtual-desktop/data-locations
Choose Azure Virtual Desktop host pool management	https://learn.microsoft.com/en-us/azure/virtual-desktop/host-pool-management-approaches
Estimate costs for Azure Virtual Desktop Insights	https://learn.microsoft.com/en-us/azure/virtual-desktop/insights-costs
Select licensing options for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/licensing
Choose management tools for Azure Virtual Desktop session hosts	https://learn.microsoft.com/en-us/azure/virtual-desktop/management
Choose Azure Virtual Desktop deployment models	https://learn.microsoft.com/en-us/azure/virtual-desktop/organization-internal-external-commercial-purposes-recommendations
Choose Azure storage options for FSLogix profiles on AVD	https://learn.microsoft.com/en-us/azure/virtual-desktop/store-fslogix-profile
Estimate and plan Azure Virtual Desktop costs	https://learn.microsoft.com/en-us/azure/virtual-desktop/understand-estimate-costs

Architecture & Design Patterns

Topic	URL
Use ephemeral OS disks for stateless AVD workloads	https://learn.microsoft.com/en-us/azure/virtual-desktop/deploy/session-hosts/ephemeral-os-disks
Design disaster recovery architecture for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/disaster-recovery-concepts
Design AVD user profile management with FSLogix containers	https://learn.microsoft.com/en-us/azure/virtual-desktop/fslogix-profile-containers
Use Automation and Logic Apps to scale AVD session hosts	https://learn.microsoft.com/en-us/azure/virtual-desktop/scaling-automation-logic-apps

Limits & Quotas

Topic	URL
Understand RDP bandwidth needs for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-bandwidth
Use Microsoft Teams features on Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/teams-supported-features

Security

Topic	URL
Control clipboard direction and data types in AVD	https://learn.microsoft.com/en-us/azure/virtual-desktop/clipboard-transfer-direction-data-types
Configure AD FS single sign-on for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-adfs-sso
Configure managed identities and permissions for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-managed-identity
Configure Microsoft Entra ID SSO for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-single-sign-on
Configure context-based redirection policies in Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/context-based-redirections-avd
Implement delegated administrative access in Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/delegated-access-virtual-desktop
Set up Kerberos KDC proxy for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/key-distribution-center-proxy
Configure Azure Virtual Desktop access for external identities	https://learn.microsoft.com/en-us/azure/virtual-desktop/provide-access-external-identities
Onboard AVD session hosts to Microsoft Purview forensic evidence	https://learn.microsoft.com/en-us/azure/virtual-desktop/purview-forensic-evidence
Use built-in Azure RBAC roles for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/rbac
Configure WebAuthn redirection for passwordless AVD

Configuration

Topic	URL
Add Azure Virtual Desktop administrative template to Group Policy and Intune	https://learn.microsoft.com/en-us/azure/virtual-desktop/administrative-template
Create MSIX images for Azure Virtual Desktop App Attach	https://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-create-msix-image
Add and manage App Attach apps in Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-setup
Apply Windows licensing to Azure Virtual Desktop session hosts	https://learn.microsoft.com/en-us/azure/virtual-desktop/apply-windows-license
Create and assign autoscale scaling plans for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-create-assign-scaling-plan
Configure diagnostics for Azure Virtual Desktop autoscale	https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-diagnostics
Deploy and access Entra-joined AVD session hosts	https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-ad-joined-session-hosts
Configure Azure fabric communication IPs for AVD and Windows 365	https://learn.microsoft.com/en-us/azure/virtual-desktop/azurecommunicationips
Configure Configuration Manager updates for AVD multi-session hosts	https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-automatic-updates
Configure Azure Virtual Desktop host pool load balancing	https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-host-pool-load-balancing
Configure RDP Shortpath transport for Azure Virtual Desktop

Integrations & Coding Patterns

Topic	URL
Use Azure CLI and PowerShell modules to manage Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/cli-powershell
Integrate WebRTC calling apps with AVD multimedia redirection	https://learn.microsoft.com/en-us/azure/virtual-desktop/multimedia-redirection-developer-integration
Use URI schemes with the AVD Remote Desktop client	https://learn.microsoft.com/en-us/azure/virtual-desktop/uri-scheme

Deployment

Topic	URL
Automatically migrate from AVD (classic) to Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/automatic-migration
Deploy Azure Virtual Desktop Hybrid On-premises	https://learn.microsoft.com/en-us/azure/virtual-desktop/deploy-azure-virtual-desktop-hybrid
Deploy Azure Virtual Desktop MMR Insider extension via Intune	https://learn.microsoft.com/en-us/azure/virtual-desktop/deploy-insider-extension
Manually migrate from AVD (classic) to Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/virtual-desktop/manual-migration
Move Azure Virtual Desktop resources between Azure regions	https://learn.microsoft.com/en-us/azure/virtual-desktop/move-resources
Deploy and manage Azure Virtual Desktop regional host pools	https://learn.microsoft.com/en-us/azure/virtual-desktop/regional-host-pools
Deploy Windows Remote Desktop client per-user via Intune or Configuration Manager	https://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/install-windows-client-per-user