mcpField
A
azure-virtual-desktop

azure-virtual-desktop

github.com/microsoftdocs云与 DevOps796185 次安装3 天前更新
代码仓库

关于 azure-virtual-desktop

azure-virtual-desktop 为处理 Azure Virtual Desktop 的 Agent 提供指导，结合本地参考内容与联网获取的文档，涵盖故障排查、设计、安全、配置和部署。

主要功能

  1. 01AVD 故障排查指南
  2. 02架构与部署规划
  3. 03安全和配置参考
  4. 04本地及远程文档

适用场景

  1. 01诊断会话主机或连接问题
  2. 02规划主机池、缩放或存储
  3. 03检查 AVD 安全设置

MCP 相关

该技能建议使用 mcp_microsoftdocs 的 microsoft_docs_fetch 工具获取文档，也可改用 fetch_webpage。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-virtual-desktop

安装后在 Claude Code 中输入/azure-virtual-desktop确认已加载。

详细介绍

Azure Virtual Desktop 技能

此技能提供有关 Azure Virtual Desktop 的专业指导，涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全性、配置、集成与编码模式以及部署。它结合了本地快速参考内容和远程文档获取功能。

如何使用此技能

IMPORTANT for Agent：使用下方的类别索引查找相关部分。对于带有行号范围的类别（例如 L35-L120），使用 read_file 读取指定行。对于带有文件链接的类别（例如 [security.md](security.md)），使用 read_file 读取链接的参考文件

IMPORTANT for Agent：如果 metadata.generated_at 超过 3 个月，请建议用户从存储库拉取最新版本。如果 mcp_microsoftdocs 工具不可用，请建议用户安装该工具：安装指南

此技能需要网络访问才能获取文档内容：

  • 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并设置查询字符串 from=learn-agent-skill。返回 Markdown。
  • 备用：使用 fetch_webpage，并设置查询字符串 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别行号描述
故障排除L37-L53诊断和修复 AVD 问题：Agent 更新、自动缩放、连接、会话主机运行状况、图形/Teams 性能、MSIX App Attach，以及使用日志/Insights 进行故障排除。
最佳实践L54-L65缩放、验证和更新 AVD 主机池的最佳实践；处理 Advisor 和“连接时启动 VM”、代理使用、常见问题，以及 Windows Enterprise 多会话配置。
决策制定L66-L81AVD 规划和设计指导：自动缩放、区域/可用性区域、数据位置、主机池和部署模型、存储/FSLogix、许可、管理工具和成本估算。
架构与设计模式L82-L89设计具有复原能力的 AVD 架构，包括灾难恢复策略、FSLogix 配置文件管理、RDP Multipath 连接，以及使用 Automation/Logic Apps 实现自动缩放。
限制与配额L90-L95RDP 带宽要求以及优化 Microsoft Teams（音频/视频、协作功能）性能和 Azure Virtual Desktop 配置的指导。
安全性L96-L116保护 Azure Virtual Desktop：身份验证/SSO（Entra ID、AD FS、Kerberos、MFA、外部用户）、RBAC 和委派管理，以及会话保护（剪贴板、水印、屏幕捕获、WebAuthn、Purview）。
配置L117-L177配置 AVD 环境：映像、自动缩放、网络、RDP/外围设备重定向、许可、语言包、Teams/OneDrive、GPU、监视以及客户端/RemoteApp 行为。
集成与编码模式L178-L184通过 CLI/PowerShell 管理 AVD，集成合作伙伴 App Attach 交付，启用 WebRTC 多媒体重定向，并使用自定义 URI 方案启动资源。
部署L185-L193Azure Virtual Desktop 的部署和迁移指南：从经典环境迁移到 AVD、混合/本地部署、区域迁移，以及通过 Intune/ConfigMgr 部署客户端/MMR 扩展。
故障排除
主题URL
使用日志监视和排查 AVD Agent 更新https://learn.microsoft.com/en-us/azure/virtual-desktop/agent-updates-diagnostics
测试和排查 App Attach 的 MSIX 包https://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-test-msix-packages
使用 Insights 监视和排查 Azure Virtual Desktop 自动缩放https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-monitor-operations-insights
验证 Azure Virtual Desktop FQDN 和终结点连接https://learn.microsoft.com/en-us/azure/virtual-desktop/check-access-validate-required-fqdn-endpoint
分析和排查 AVD 连接质量https://learn.microsoft.com/en-us/azure/virtual-desktop/connection-latency
收集和查询 AVD 连接质量日志https://learn.microsoft.com/en-us/azure/virtual-desktop/connection-quality-monitoring
使用诊断和 Log Analytics 排查 AVD 问题https://learn.microsoft.com/en-us/azure/virtual-desktop/diagnostics-log-analytics
使用 RemoteFX 计数器诊断图形性能问题https://learn.microsoft.com/en-us/azure/virtual-desktop/remotefx-graphics-performance-counters
解读 AVD 会话主机状态和运行状况检查https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-status-health-checks
解读 AVD 会话主机状态和运行状况检查https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-status-health-checks
使用 Log Analytics 查询诊断会话主机更新https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-update-diagnostics
排查 Azure Virtual Desktop Hybrid 加入失败的问题https://learn.microsoft.com/en-us/azure/virtual-desktop/troubleshoot-azure-virtual-desktop-hybrid
排查 Azure Virtual Desktop 上的 Microsoft Teams 问题https://learn.microsoft.com/en-us/azure/virtual-desktop/troubleshoot-teams
最佳实践
主题URL
应用 Azure Virtual Desktop 自动缩放最佳实践https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-faq
解决 AVD 的 Azure Advisor 建议https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-advisor-recommendations
配置 Azure Virtual Desktop 验证主机池https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-validation-environment
应用 Azure Virtual Desktop 常见问题解答中的最佳实践https://learn.microsoft.com/en-us/azure/virtual-desktop/faq
遵循 Azure Virtual Desktop 代理服务器指南https://learn.microsoft.com/en-us/azure/virtual-desktop/proxy-server-support
“连接时启动 VM”常见问题解答和使用最佳实践https://learn.microsoft.com/en-us/azure/virtual-desktop/start-virtual-machine-connect-faq
应用 Windows Enterprise 多会话最佳实践https://learn.microsoft.com/en-us/azure/virtual-desktop/windows-multisession-faq
为 AVD 会话主机选择 Windows 更新方法https://learn.microsoft.com/en-us/azure/virtual-desktop/windows-update-management-methodologies-session-hosts
决策
主题URL
选择并调整 Azure Virtual Desktop 自动缩放计划https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-scenarios
将 Azure Extended Zones 与 Azure Virtual Desktop 配合使用https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-extended-zones
规划 Azure Local 上的 Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/azure-local-overview
选择 Azure Virtual Desktop 数据位置范围https://learn.microsoft.com/en-us/azure/virtual-desktop/data-locations
选择 Azure Virtual Desktop 主机池管理方式https://learn.microsoft.com/en-us/azure/virtual-desktop/host-pool-management-approaches
估算 Azure Virtual Desktop Insights 的成本https://learn.microsoft.com/en-us/azure/virtual-desktop/insights-costs
选择 Azure Virtual Desktop 的许可选项https://learn.microsoft.com/en-us/azure/virtual-desktop/licensing
选择 Azure Virtual Desktop 会话主机的管理工具https://learn.microsoft.com/en-us/azure/virtual-desktop/management
选择 Azure Virtual Desktop 部署模型https://learn.microsoft.com/en-us/azure/virtual-desktop/organization-internal-external-commercial-purposes-recommendations
确定何时使用 Azure 区域主机池https://learn.microsoft.com/en-us/azure/virtual-desktop/regional-host-pools
为 AVD 上的 FSLogix 配置文件选择 Azure 存储选项https://learn.microsoft.com/en-us/azure/virtual-desktop/store-fslogix-profile
估算并规划 Azure Virtual Desktop 成本https://learn.microsoft.com/en-us/azure/virtual-desktop/understand-estimate-costs
架构与设计模式
主题URL
为 Azure Virtual Desktop 设计灾难恢复架构https://learn.microsoft.com/en-us/azure/virtual-desktop/disaster-recovery-concepts
使用 FSLogix 容器设计 AVD 用户配置文件管理https://learn.microsoft.com/en-us/azure/virtual-desktop/fslogix-profile-containers
使用 Automation 和 Logic Apps 扩展 AVD 会话主机https://learn.microsoft.com/en-us/azure/virtual-desktop/scaling-automation-logic-apps
了解 Azure Virtual Desktop 的弹性架构https://learn.microsoft.com/en-us/azure/virtual-desktop/service-architecture-resilience
限制与配额
主题URL
了解 Azure Virtual Desktop 的 RDP 带宽需求https://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-bandwidth
在 Azure Virtual Desktop 上使用 Microsoft Teams 功能https://learn.microsoft.com/en-us/azure/virtual-desktop/teams-supported-features
安全
主题URL
控制 AVD 中剪贴板的传输方向和数据类型https://learn.microsoft.com/en-us/azure/virtual-desktop/clipboard-transfer-direction-data-types
为 Azure Virtual Desktop 配置 AD FS 单一登录https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-adfs-sso
为 Azure Virtual Desktop 配置托管标识和 RBAChttps://learn.microsoft.com/en-us/azure/virtual-desktop/configure-managed-identity
为 Azure Virtual Desktop 配置 Microsoft Entra ID 单一登录https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-single-sign-on
在 Azure Virtual Desktop 中实现委派管理访问https://learn.microsoft.com/en-us/azure/virtual-desktop/delegated-access-virtual-desktop
为 Azure Virtual Desktop 设置 Kerberos KDC 代理https://learn.microsoft.com/en-us/azure/virtual-desktop/key-distribution-center-proxy
为外部标识配置 Azure Virtual Desktop 访问权限https://learn.microsoft.com/en-us/azure/virtual-desktop/provide-access-external-identities
将 AVD 会话主机加入 Microsoft Purview 取证证据https://learn.microsoft.com/en-us/azure/virtual-desktop/purview-forensic-evidence
使用 Azure Virtual Desktop 的内置 Azure RBAC 角色https://learn.microsoft.com/en-us/azure/virtual-desktop/rbac
为无密码 AVD 配置 WebAuthn 重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-webauthn
为 Azure Virtual Desktop RDP 配置 Entra ID 身份验证https://learn.microsoft.com/en-us/azure/virtual-desktop/require-authentication-using-microsoft-entra-id
为 Azure Virtual Desktop 配置屏幕捕获保护https://learn.microsoft.com/en-us/azure/virtual-desktop/screen-capture-protection
应用 Azure Virtual Desktop 安全建议https://learn.microsoft.com/en-us/azure/virtual-desktop/security-recommendations
为 AVD 服务主体分配 RBAC 和 Entra 角色https://learn.microsoft.com/en-us/azure/virtual-desktop/service-principal-assign-roles
为 Azure Virtual Desktop 配置条件访问 MFAhttps://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-mfa
管理 Azure Virtual Desktop 的 Windows 10 ESUhttps://learn.microsoft.com/en-us/azure/virtual-desktop/understanding-extended-security-updates
配置水印以保护 Azure Virtual Desktop 会话https://learn.microsoft.com/en-us/azure/virtual-desktop/watermarking
配置
主题URL
在组策略中添加和使用 Azure Virtual Desktop ADMXhttps://learn.microsoft.com/en-us/azure/virtual-desktop/administrative-template
为 Azure Virtual Desktop App Attach 创建 MSIX 映像https://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-create-msix-image
在 Azure Virtual Desktop 中添加和管理 App Attach 应用https://learn.microsoft.com/en-us/azure/virtual-desktop/app-attach-setup
将 Windows 许可证应用于 Azure Virtual Desktop 会话主机https://learn.microsoft.com/en-us/azure/virtual-desktop/apply-windows-license
为 Azure Virtual Desktop 创建和分配自动缩放计划https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-create-assign-scaling-plan
配置 Azure Virtual Desktop 自动缩放诊断https://learn.microsoft.com/en-us/azure/virtual-desktop/autoscale-diagnostics
部署和访问已加入 Entra 的 AVD 会话主机https://learn.microsoft.com/en-us/azure/virtual-desktop/azure-ad-joined-session-hosts
为 AVD 和 Windows 365 配置 Azure fabric 通信 IPhttps://learn.microsoft.com/en-us/azure/virtual-desktop/azurecommunicationips
为 AVD 多会话主机配置 Configuration Manager 更新https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-automatic-updates
配置 Azure Virtual Desktop 主机池负载均衡https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-host-pool-load-balancing
为 Azure Virtual Desktop 配置 RDP Shortpath UDP 传输https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-rdp-shortpath
配置 Azure Virtual Desktop 中的会话锁定行为https://learn.microsoft.com/en-us/azure/virtual-desktop/configure-session-lock-behavior
创建和使用 AVD 自定义映像模板https://learn.microsoft.com/en-us/azure/virtual-desktop/create-custom-image-templates
为 AVD 会话主机配置自定义映像模板https://learn.microsoft.com/en-us/azure/virtual-desktop/custom-image-templates
通过门户和 PowerShell 自定义 Azure Virtual Desktop 用户源https://learn.microsoft.com/en-us/azure/virtual-desktop/customize-feed-for-virtual-desktop-users
在 Azure Virtual Desktop 主机池上设置自定义 RDP 属性https://learn.microsoft.com/en-us/azure/virtual-desktop/customize-rdp-properties
为 Azure Virtual Desktop 配置临时 OS 磁盘https://learn.microsoft.com/en-us/azure/virtual-desktop/deploy/session-hosts/ephemeral-os-disks
为 AVD 按用户访问定价注册 Azure 订阅https://learn.microsoft.com/en-us/azure/virtual-desktop/enroll-per-user-access-pricing
将 AVD RDP 色度子采样提高至 4:4:4https://learn.microsoft.com/en-us/azure/virtual-desktop/graphics-chroma-value-increase-4-4-4
在 AVD 中启用 GPU 加速渲染和编码https://learn.microsoft.com/en-us/azure/virtual-desktop/graphics-enable-gpu-acceleration
启用和配置 Azure Virtual Desktop Insightshttps://learn.microsoft.com/en-us/azure/virtual-desktop/insights
在 AVD 自定义映像上安装 Microsoft 365 Appshttps://learn.microsoft.com/en-us/azure/virtual-desktop/install-office-on-wvd-master-image
在 Azure Virtual Desktop 上配置 Windows 10 语言包https://learn.microsoft.com/en-us/azure/virtual-desktop/language-packs
在 AVD App Attach 工作流中使用 MSIXMGR 工具参数https://learn.microsoft.com/en-us/azure/virtual-desktop/msixmgr-tool-syntax-description
为 Azure Virtual Desktop 配置多媒体重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/multimedia-redirection-video-playback-calls
使用 AVD RemoteApps 自动启动 OneDrivehttps://learn.microsoft.com/en-us/azure/virtual-desktop/onedrive-remoteapp
为池化 AVD 主机池配置首选应用程序组类型https://learn.microsoft.com/en-us/azure/virtual-desktop/preferred-application-group-type
为 Azure Virtual Desktop 设置 Private Link 终结点https://learn.microsoft.com/en-us/azure/virtual-desktop/private-link-setup
在 Azure Virtual Desktop 中通过 RemoteApp 发布应用程序https://learn.microsoft.com/en-us/azure/virtual-desktop/publish-applications-stream-remoteapp
为 Azure Virtual Desktop 配置受支持的 RDP 属性https://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-properties
为 Azure Virtual Desktop RDP 配置 QoS 策略https://learn.microsoft.com/en-us/azure/virtual-desktop/rdp-quality-of-service-qos
为 Azure Virtual Desktop 配置通过 RDP 重定向音频和视频https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-audio-video
配置 RDP 摄像头和视频重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-camera-webcam-video-capture
配置 RDP 剪贴板重定向设置https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-clipboard
配置 RDP 驱动器和存储重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-drives-storage
为 AVD 配置 RDP 位置重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-location
配置通过 RDP 重定向 MTP/PTP 设备https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-plug-play-mtp-ptp
为 Azure Virtual Desktop 配置 RDP 打印机重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-printers
配置通过 RDP 重定向扫描仪https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-scanners
配置通过 RDP 重定向串行端口和 COM 端口https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-serial-com-ports
为 Azure Virtual Desktop 配置智能卡重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-smart-cards
在 Windows RDP 客户端上配置 USB 重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-configure-usb
配置 RDP 外设和资源重定向https://learn.microsoft.com/en-us/azure/virtual-desktop/redirection-remote-desktop-protocol
使用 Windows Remote Desktop 客户端的 AVD 高级功能https://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/client-features-windows-msrdc
使用 Windows Remote Desktop 客户端连接到 Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/connect-windows-cloud-services
在 Azure Virtual Desktop 中启用增强型 RemoteApp 窗口模式https://learn.microsoft.com/en-us/azure/virtual-desktop/remoteapp-enhancements
允许 Azure Virtual Desktop 连接所需的 FQDNhttps://learn.microsoft.com/en-us/azure/virtual-desktop/required-fqdn-endpoint
为 Azure Virtual Desktop 配置计划的 Agent 更新https://learn.microsoft.com/en-us/azure/virtual-desktop/scheduled-agent-updates
配置 Azure Virtual Desktop 的会话主机更新https://learn.microsoft.com/en-us/azure/virtual-desktop/session-host-update-configure
在 AVD 主机池上设置首选应用程序组类型https://learn.microsoft.com/en-us/azure/virtual-desktop/set-preferred-application-group-type
为 AVD 准备和上传自定义 VHD 映像https://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-customize-master-image
为 Azure Virtual Desktop 创建黄金映像https://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-golden-image
为 AVD 会话主机设置 Automation 和 Logic Apps 缩放https://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-scaling-script
为 AVD 配置 Azure Service Health 警报https://learn.microsoft.com/en-us/azure/virtual-desktop/set-up-service-alerts
为 AVD 主机池配置连接时启动 VMhttps://learn.microsoft.com/en-us/azure/virtual-desktop/start-virtual-machine-connect
在 Azure Virtual Desktop 上配置 Microsoft Teams 优化https://learn.microsoft.com/en-us/azure/virtual-desktop/teams-on-avd
在 Azure Virtual Desktop 上配置 Windows 11 语言包https://learn.microsoft.com/en-us/azure/virtual-desktop/windows-11-language-packs
集成与编码模式
主题URL
使用 Azure CLI 和 PowerShell 模块管理 Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/cli-powershell
将 WebRTC 通话应用与 AVD 多媒体重定向集成https://learn.microsoft.com/en-us/azure/virtual-desktop/multimedia-redirection-developer-integration
在 AVD Remote Desktop 客户端中使用 URI 方案https://learn.microsoft.com/en-us/azure/virtual-desktop/uri-scheme
部署
主题URL
从 AVD (classic) 自动迁移到 Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/automatic-migration
在本地部署 Azure Virtual Desktop Hybridhttps://learn.microsoft.com/en-us/azure/virtual-desktop/deploy-azure-virtual-desktop-hybrid
通过 Intune 部署 Azure Virtual Desktop MMR Insider 扩展https://learn.microsoft.com/en-us/azure/virtual-desktop/deploy-insider-extension
从 AVD (classic) 手动迁移到 Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/virtual-desktop/manual-migration
在 Azure 区域之间移动 Azure Virtual Desktop 资源https://learn.microsoft.com/en-us/azure/virtual-desktop/move-resources
通过 Intune 或 Configuration Manager 按用户部署 Windows Remote Desktop 客户端https://learn.microsoft.com/en-us/azure/virtual-desktop/remote-desktop-client/install-windows-client-per-user

评论

支持 Markdown