/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 configuring session hosts, FSLogix profiles, autoscale, MSIX App Attach, or Teams media 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-11-08"
  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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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-L68 | Best practices for scaling, performance, media/Teams optimization, networking (proxy, Shortpath), validation pools, Start VM on Connect, and updating Windows multi-session hosts. | | Decision Making | L69-L83 | Guidance on planning and choosing AVD deployment models, regions, autoscale, data/storage, host pool and session host management, and estimating AVD and Insights costs. | | Architecture & Design Patterns | L84-L91 | Designing resilient AVD architectures, including DR strategies, FSLogix profile management, RDP Multipath connectivity, and automated scaling with Automation/Logic Apps. | | Limits & Quotas | L92-L97 | Guidance on RDP bandwidth requirements and optimizing Microsoft Teams (audio/video, collaboration features) performance and configuration in Azure Virtual Desktop. | | Security | L98-L119 | Securing Azure Virtual Desktop: identity/SO, MFA/Conditional Access, RBAC/roles, Kerberos/KDC, clipboard/screen/watermark controls, external identities, Purview evidence, and ESU management. | | Configuration | L120-L177 | Configuring AVD session hosts, images, autoscale, networking, RDP/peripheral redirection, licensing, monitoring, and app delivery (MSIX/App Attach, RemoteApps, user feed, GPU, updates). | | Integrations & Coding Patterns | L178-L184 | Managing AVD via CLI/PowerShell, integrating partner App Attach delivery, enabling WebRTC multimedia redirection, and launching resources using custom URI schemes. | | Deployment | L185-L193 | Guides for deploying and migrating Azure Virtual Desktop: classic-to-AVD migration, hybrid/on-prem setups, region moves, and client/MMR extension deployment via Intune/Config Manager. |

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 | | Use Log Analytics queries to diagnose session host updates | https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-update-diagnostics | | Troubleshoot Azure Virtual Desktop Hybrid onboarding failures | https://learn.microsoft.com/en-us/azure/virtual-desktop/troubleshoot-azure-virtual-desktop-hybrid | | Troubleshoot Microsoft Teams on Azure V