azure-virtual-desktop

v2026.09.24

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 host pools, autoscale, FSLogix profiles, MSIX App Attach, Teams optimization, or AVD SSO, and other Azure Virtual Desktop related development tasks. Not for Azure Virtual Machines (use azure-virtual-machines), Azure Dev Box (use azure-dev-box).

GitHub
安装命令
npx skhub add microsoftdocs/azure-virtual-desktop
Markdown
SKILL.md

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

CategoryLinesDescription
TroubleshootingL37-L53Diagnosing and fixing AVD issues: agent updates, autoscale, connectivity, session host health, graphics/Teams performance, MSIX App Attach, and using logs/Insights for troubleshooting.
Best PracticesL54-L65Best practices for scaling, validating, and updating AVD host pools; handling Advisor and Start VM on Connect, proxy usage, FAQs, and Windows Enterprise multi-session configuration.
Decision MakingL66-L81Planning and choosing AVD deployment models, autoscale, regions, data locations, storage, licensing, management tools, and estimating/optimizing AVD and Insights costs
Architecture & Design PatternsL82-L90Patterns for designing AVD deployments: stateless hosts with ephemeral disks, DR architectures, FSLogix profile design, RDP Multipath connectivity, and automated scaling with Logic Apps.
Limits & QuotasL91-L96Guidance on RDP bandwidth requirements and optimizing Microsoft Teams (audio/video, collaboration features) performance and configuration in Azure Virtual Desktop.
SecurityL97-L118Securing Azure Virtual Desktop: SSO/auth (Entra, AD FS, Kerberos, WebAuthn, MFA, external IDs), RBAC/roles, clipboard/redirection policies, watermarking, screen capture, Purview, and security best practices.
ConfigurationL119-L178Configuring AVD environments: images, autoscale, networking, RDP/peripheral redirection, licensing, app attach, Teams/Office, language packs, monitoring, and client/host pool behavior.
Integrations & Coding PatternsL179-L185Managing AVD via CLI/PowerShell, integrating partner App Attach delivery, enabling WebRTC multimedia redirection, and launching resources using custom URI schemes.
DeploymentL186-L194Guides for deploying and migrating Azure Virtual Desktop: classic-to-AVD moves, hybrid/on-prem setups, region moves, and client/MMR extension deployment via Intune/ConfigMgr.

Troubleshooting

TopicURL
Monitor and troubleshoot AVD agent updates with logshttps://learn.microsoft.com/en-us/azure/virtual-desktop/agent-updates-diagnostics
Test and troubleshoot MSIX packages for App Attachhttps://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-test-msix-packages
Monitor and troubleshoot Azure Virtual Desktop autoscale with Insightshttps://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-monitor-operations-insights
Validate Azure Virtual Desktop FQDN and endpoint connectivityhttps://learn.microsoft.com/en-us/azure/virtual-desktop/check-access-validate-required-fqdn-endpoint
Analyze and troubleshoot AVD connection qualityhttps://learn.microsoft.com/en-us/azure/virtual-desktop/connection-latency
Collect and query AVD connection quality logshttps://learn.microsoft.com/en-us/azure/virtual-desktop/connection-quality-monitoring
Use diagnostics and Log Analytics for AVD issueshttps://learn.microsoft.com/en-us/azure/virtual-desktop/diagnostics-log-analytics
Diagnose graphics performance issues with RemoteFX countershttps://learn.microsoft.com/en-us/azure/virtual-desktop/remotefx-graphics-performance-counters
Interpret AVD session host statuses and health checkshttps://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-status-health-checks
Interpret AVD session host statuses and health checkshttps://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-status-health-checks
Use Log Analytics queries to diagnose session host updateshttps://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-update-diagnostics
Troubleshoot Azure Virtual Desktop Hybrid onboarding failureshttps://learn.microsoft.com/en-us/azure/virtual-desktop/troubleshoot-azure-virtual-desktop-hybrid
Troubleshoot Microsoft Teams on Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/troubleshoot-teams

Best Practices

TopicURL
Apply autoscale best practices for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-faq
Resolve Azure Advisor recommendations for AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/azure-advisor-recommendations
Configure Azure Virtual Desktop validation host poolshttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-validation-environment
Apply Azure Virtual Desktop FAQ best practiceshttps://learn.microsoft.com/en-us/azure/virtual-desktop/faq
Apply proxy server guidelines for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/proxy-server-support
Start VM on Connect FAQ and usage best practiceshttps://learn.microsoft.com/en-us/azure/virtual-desktop/start-virtual-machine-connect-faq
Apply best practices for Windows Enterprise multi-sessionhttps://learn.microsoft.com/en-us/azure/virtual-desktop/windows-multisession-faq
Choose Windows update methods for AVD session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/windows-update-management-methodologies-session-hosts

Decision Making

TopicURL
Choose and tune Azure Virtual Desktop autoscale planshttps://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-scenarios
Use Azure Extended Zones with Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/azure-extended-zones
Plan Azure Virtual Desktop on Azure Localhttps://learn.microsoft.com/en-us/azure/virtual-desktop/azure-local-overview
Understand Azure Virtual Desktop data locationshttps://learn.microsoft.com/en-us/azure/virtual-desktop/data-locations
Choose Azure Virtual Desktop host pool managementhttps://learn.microsoft.com/en-us/azure/virtual-desktop/host-pool-management-approaches
Estimate costs for Azure Virtual Desktop Insightshttps://learn.microsoft.com/en-us/azure/virtual-desktop/insights-costs
Select licensing options for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/licensing
Choose management tools for Azure Virtual Desktop session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/management
Choose Azure Virtual Desktop deployment modelshttps://learn.microsoft.com/en-us/azure/virtual-desktop/organization-internal-external-commercial-purposes-recommendations
Decide when to use Azure regional host poolshttps://learn.microsoft.com/en-us/azure/virtual-desktop/regional-host-pools
Choose Azure storage options for FSLogix profiles on AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/store-fslogix-profile
Estimate and plan Azure Virtual Desktop costshttps://learn.microsoft.com/en-us/azure/virtual-desktop/understand-estimate-costs

Architecture & Design Patterns

TopicURL
Use ephemeral OS disks for stateless AVD workloadshttps://learn.microsoft.com/en-us/azure/virtual-desktop/deploy/session-hosts/ephemeral-os-disks
Design disaster recovery architecture for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/disaster-recovery-concepts
Design AVD user profile management with FSLogix containershttps://learn.microsoft.com/en-us/azure/virtual-desktop/fslogix-profile-containers
Use RDP Multipath to optimize Azure Virtual Desktop connectivityhttps://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-multipath
Use Automation and Logic Apps to scale AVD session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/scaling-automation-logic-apps

Limits & Quotas

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

Security

TopicURL
Control clipboard direction and data types in AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/clipboard-transfer-direction-data-types
Configure AD FS single sign-on for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-adfs-sso
Configure managed identities and permissions for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-managed-identity
Configure Microsoft Entra ID SSO for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-single-sign-on
Configure context-based redirection policies in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/context-based-redirections-avd
Implement delegated administrative access in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/delegated-access-virtual-desktop
Set up Kerberos KDC proxy for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/key-distribution-center-proxy
Configure Azure Virtual Desktop access for external identitieshttps://learn.microsoft.com/en-us/azure/virtual-desktop/provide-access-external-identities
Onboard AVD session hosts to Microsoft Purview forensic evidencehttps://learn.microsoft.com/en-us/azure/virtual-desktop/purview-forensic-evidence
Use built-in Azure RBAC roles for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/rbac
Configure WebAuthn redirection for passwordless AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-webauthn
Configure Entra ID authentication for Azure Virtual Desktop RDPhttps://learn.microsoft.com/en-us/azure/virtual-desktop/require-authentication-using-microsoft-entra-id
Configure screen capture protection in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/screen-capture-protection
Apply security recommendations for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/security-recommendations
Assign RBAC and Entra roles to AVD service principalshttps://learn.microsoft.com/en-us/azure/virtual-desktop/service-principal-assign-roles
Configure Conditional Access MFA for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-mfa
Manage Windows 10 ESU for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/understanding-extended-security-updates
Configure watermarking to protect Azure Virtual Desktop sessionshttps://learn.microsoft.com/en-us/azure/virtual-desktop/watermarking

Configuration

TopicURL
Add Azure Virtual Desktop administrative template to Group Policy and Intunehttps://learn.microsoft.com/en-us/azure/virtual-desktop/administrative-template
Create MSIX images for Azure Virtual Desktop App Attachhttps://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-create-msix-image
Add and manage App Attach apps in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-setup
Apply Windows licensing to Azure Virtual Desktop session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/apply-windows-license
Create and assign autoscale scaling plans for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-create-assign-scaling-plan
Configure diagnostics for Azure Virtual Desktop autoscalehttps://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-diagnostics
Deploy and access Entra-joined AVD session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/azure-ad-joined-session-hosts
Configure Azure fabric communication IPs for AVD and Windows 365https://learn.microsoft.com/en-us/azure/virtual-desktop/azurecommunicationips
Configure Configuration Manager updates for AVD multi-session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-automatic-updates
Configure Azure Virtual Desktop host pool load balancinghttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-host-pool-load-balancing
Configure RDP Shortpath transport for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-rdp-shortpath
Configure session lock behavior in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-session-lock-behavior
Create and use AVD custom image templateshttps://learn.microsoft.com/en-us/azure/virtual-desktop/create-custom-image-templates
Configure custom image templates for AVD session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/custom-image-templates
Customize Azure Virtual Desktop user feed via portal and PowerShellhttps://learn.microsoft.com/en-us/azure/virtual-desktop/customize-feed-for-virtual-desktop-users
Set custom RDP properties on Azure Virtual Desktop host poolshttps://learn.microsoft.com/en-us/azure/virtual-desktop/customize-rdp-properties
Enroll Azure subscriptions in AVD per-user access pricinghttps://learn.microsoft.com/en-us/azure/virtual-desktop/enroll-per-user-access-pricing
Increase AVD RDP chroma subsampling to 4:4:4https://learn.microsoft.com/en-us/azure/virtual-desktop/graphics-chroma-value-increase-4-4-4
Enable GPU-accelerated rendering and encoding in AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/graphics-enable-gpu-acceleration
Enable and configure Azure Virtual Desktop Insightshttps://learn.microsoft.com/en-us/azure/virtual-desktop/insights
Install Microsoft 365 Apps on AVD custom imageshttps://learn.microsoft.com/en-us/azure/virtual-desktop/install-office-on-wvd-master-image
Configure Windows 10 language packs on Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/language-packs
Use MSIXMGR tool parameters for AVD App Attach workflowshttps://learn.microsoft.com/en-us/azure/virtual-desktop/msixmgr-tool-syntax-description
Configure multimedia redirection for Azure Virtual Desktop sessionshttps://learn.microsoft.com/en-us/azure/virtual-desktop/multimedia-redirection-video-playback-calls
Launch OneDrive automatically with AVD RemoteAppshttps://learn.microsoft.com/en-us/azure/virtual-desktop/onedrive-remoteapp
Configure preferred application group type for pooled AVD host poolshttps://learn.microsoft.com/en-us/azure/virtual-desktop/preferred-application-group-type
Set up Private Link endpoints for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/private-link-setup
Publish applications with RemoteApp in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/publish-applications-stream-remoteapp
Configure supported RDP properties for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-properties
Configure QoS policies for Azure Virtual Desktop RDPhttps://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-quality-of-service-qos
Configure audio and video redirection over RDP for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-audio-video
Configure RDP camera and video redirectionhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-camera-webcam-video-capture
Configure RDP clipboard redirection settingshttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-clipboard
Configure RDP drive and storage redirectionhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-drives-storage
Configure RDP location redirection for AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-location
Configure MTP/PTP device redirection over RDPhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-plug-play-mtp-ptp
Configure RDP printer redirection for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-printers
Configure scanner redirection over RDPhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-scanners
Configure serial and COM port redirection over RDPhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-serial-com-ports
Configure smart card redirection for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-smart-cards
Configure USB redirection on Windows RDP clientshttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-usb
Configure RDP peripheral and resource redirectionhttps://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-remote-desktop-protocol
Use advanced features of the Windows Remote Desktop client for AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/client-features-windows-msrdc
Connect to Azure Virtual Desktop using the Windows Remote Desktop clienthttps://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/connect-windows-cloud-services
Enable enhanced RemoteApp windowing in Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/remoteapp-enhancements
Allow required FQDNs for Azure Virtual Desktop connectivityhttps://learn.microsoft.com/en-us/azure/virtual-desktop/required-fqdn-endpoint
Configure scheduled agent updates for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/scheduled-agent-updates
Configure session host update for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-update-configure
Set preferred application group type on AVD host poolshttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-preferred-application-group-type
Prepare and upload a custom VHD image for AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-customize-master-image
Build a golden image for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-golden-image
Set up Automation and Logic Apps scaling for AVD session hostshttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-scaling-script
Configure Azure Service Health alerts for AVDhttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-service-alerts
Configure Start VM on Connect for AVD host poolshttps://learn.microsoft.com/en-us/azure/virtual-desktop/start-virtual-machine-connect
Configure Microsoft Teams optimizations on Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/teams-on-avd
Configure Windows 11 language packs on Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/windows-11-language-packs

Integrations & Coding Patterns

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

Deployment

TopicURL
Automatically migrate from AVD (classic) to Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/automatic-migration
Deploy Azure Virtual Desktop Hybrid on-premiseshttps://learn.microsoft.com/en-us/azure/virtual-desktop/deploy-azure-virtual-desktop-hybrid
Deploy Azure Virtual Desktop MMR Insider extension via Intunehttps://learn.microsoft.com/en-us/azure/virtual-desktop/deploy-insider-extension
Manually migrate from AVD (classic) to Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/manual-migration
Move Azure Virtual Desktop resources between Azure regionshttps://learn.microsoft.com/en-us/azure/virtual-desktop/move-resources
Deploy Windows Remote Desktop client per-user via Intune or Configuration Managerhttps://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/install-windows-client-per-user
发现
标签

此技能尚未发布标签。

版本
最新版本元数据

版本

v2026.09.24

发布时间

Sep 24, 2026

分类

未分类

许可证

CC-BY-4.0

源路径

skills/azure-virtual-desktop

默认分支

main

最新提交

1e593dd

Tree SHA

a074c78