azure-dev-box

Azure Dev Box 技能

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

如何使用此技能

重要提示（面向 Agent）：使用下方的类别索引查找相关部分。对于包含行范围的类别（例如 L35-L120），请使用 read_file 读取指定行。对于包含文件链接的类别（例如 [security.md](security.md)），请使用 read_file 读取链接指向的参考文件。

重要提示（面向 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。

类别索引

类别	行	说明
故障排除	L36-L45	诊断并修复 Dev Box 连接问题、映像验证错误、过期或无法访问的开发箱，使用“疑难解答和修复”，以及通过 Azure Monitor 日志进行监视。
最佳实践	L46-L51	有关构建高效 Dev Box 映像的指导，包括构建映像定义，以及预热 Visual Studio 缓存以加快开发环境的启动速度。
决策	L52-L57	规划 Dev Box 部署（架构、规格和治理），以及安全、高效地停用或退役 Dev Box 环境的策略。
限制和配额	L58-L63	管理 Dev Box 容量：申请提高配额或核心数限制，并配置每位用户的 Dev Box 限制，以控制使用量和成本。
安全性	L64-L75	保护 Dev Box 访问和会话：RBAC 角色、来宾访问、SSO、API 身份验证、Key Vault/服务主体、Intune 条件访问和终结点特权管理。
配置	L76-L101	配置 Dev Box 基础结构：网络、映像、目录、策略、计划（停止/休眠/自动删除）、池/项目/开发中心，以及监视和日志架构。
集成和编码模式	L102-L106	使用 VS Code 开发隧道安全地连接到 Azure Dev Box，包括设置、身份验证和远程开发工作流配置。
部署	L107-L110	规划和推出 Dev Box 环境，包括架构和配置，以及在 Azure 区域之间迁移 Dev Box 池和单个开发箱的指导。

故障排除

主题	URL
诊断并修复 Microsoft Dev Box 连接问题	https://learn.microsoft.com/en-us/azure/dev-box/how-to-resolve-dev-box-connectivity-issues
排查 Dev Box 自定义映像验证失败问题	https://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-custom-image-validation
修复“任务”视图中过期或无法访问的 Dev Box	https://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-dev-box-task-view
排查已知的 Dev Box 连接问题	https://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-remote-desktop-connectivity
使用 Dev Box“疑难解答和修复”排查连接问题	https://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-repair-dev-box
使用 Azure Monitor 诊断日志监视 Dev Box	https://learn.microsoft.com/en-us/azure/dev-box/monitor-dev-box

最佳实践

主题	URL
编写 Dev Box 映像定义的最佳实践	https://learn.microsoft.com/en-us/azure/dev-box/concept-authoring-troubleshooting-guide-team-customizations
在 Dev Box 映像中预生成 Visual Studio 缓存	https://learn.microsoft.com/en-us/azure/dev-box/how-to-generate-visual-studio-caches

决策

主题	URL
规划和设计 Microsoft Dev Box 部署	https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-deployment-guide
规划并执行 Microsoft Dev Box 退役	https://learn.microsoft.com/en-us/azure/dev-box/dev-box-retirement-guide

限制和配额

主题	URL
申请提高 Dev Box 配额和核心数限制	https://learn.microsoft.com/en-us/azure/dev-box/how-to-request-quota-increase
设置每位用户的 Dev Box 限制以控制成本	https://learn.microsoft.com/en-us/azure/dev-box/tutorial-dev-box-limits

安全性

主题	URL
规划 Dev Box 部署的 Azure RBAC 角色	https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-role-based-access-control
使用 Azure CLI 对 Dev Box REST API 进行身份验证	https://learn.microsoft.com/en-us/azure/dev-box/how-to-authenticate
使用条件访问策略保护 Dev Box 隧道	https://learn.microsoft.com/en-us/azure/dev-box/how-to-conditional-access-dev-tunnels-service
为 Dev Box 配置 Intune 条件访问	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-intune-conditional-access-policies
使用 Key Vault 和服务主体保护 Dev Box 自定义项	https://learn.microsoft.com/en-us/azure/dev-box/how-to-customizations-connect-resource-repository
为 Dev Box 设置 Intune Endpoint Privilege Management	https://learn.microsoft.com/en-us/azure/dev-box/how-to-elevate-privilege-dev-box
在 Dev Box 上启用 Windows 单一登录	https://learn.microsoft.com/en-us/azure/dev-box/how-to-enable-single-sign-on
为项目访问分配 Dev Box RBAC 角色	https://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-access

配置

主题	URL
配置 Microsoft Dev Box 的网络要求	https://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-network-requirements
配置 Dev Box 未使用环境的自动删除	https://learn.microsoft.com/en-us/azure/dev-box/how-to-auto-delete-dev-box
为 Dev Box 附加并配置 Azure Compute Gallery	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-azure-compute-gallery
添加和管理用于映像定义的 Dev Box 目录	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-catalog
配置 Dev Box 自定义任务目录	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-customization-tasks
配置 Dev Box 休眠和计划	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-dev-box-hibernation
为 Dev Box 团队自定义配置映像管道	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-dev-center-imaging
配置 Dev Box 网络连接和 VNet	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-network-connections
配置 Dev Box 项目治理策略	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-project-policy
配置 Dev Box 池自动停止计划	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-stop-schedule
为团队自定义编写 Dev Box 映像定义文件	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-team-customizations
创建并上传 Dev Box 用户自定义文件	https://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-user-customizations
配置 Dev Box 中的虚拟交换机和网络	https://learn.microsoft.com/en-us/azure/dev-box/how-to-connect-dev-box-virtual-switch
使用 Azure VM Image Builder 构建自定义 Dev Box 映像	https://learn.microsoft.com/en-us/azure/dev-box/how-to-customize-devbox-azure-image-builder
配置和管理 Dev Box 池	https://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-pools
管理 Microsoft Dev Box 项目和池	https://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-projects
创建和管理 Dev Box 开发中心	https://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-center
为 Microsoft Dev Box 配置自定义 Windows 映像	https://learn.microsoft.com/en-us/azure/dev-box/how-to-prepare-custom-image-dev-box
Dev Box 监视日志和指标参考	https://learn.microsoft.com/en-us/azure/dev-box/monitor-dev-box-reference
配置 Microsoft Dev Box 核心资源	https://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service
使用 Get Started 模板配置 Dev Box 资源	https://learn.microsoft.com/en-us/azure/dev-box/quickstart-get-started-template
配置 Dev Box imagedefinition.yaml 和 task.yaml 架构	https://learn.microsoft.com/en-us/azure/dev-box/reference-dev-box-customizations

集成与编码模式

主题	URL
使用 dev tunnels 从 VS Code 连接到 Dev Box	https://learn.microsoft.com/en-us/azure/dev-box/how-to-set-up-dev-tunnels

部署

主题	URL
在区域之间移动 Dev Box 池和 Box	https://learn.microsoft.com/en-us/azure/dev-box/how-to-move-dev-box-pool-region