Skip to content
LiveNew tools this week
Submit
AIMarketly
azure-dev-box logo

azure-dev-box

Expert knowledge for Azure Dev Box development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Dev Box images, catalogs, policies, schedules, RBAC/SSO access, or VS Code dev tu...

MicrosoftDocs/Agent-Skills0installs770stars

SKILL.md

Full skill instructions

Azure Dev Box Skill

This skill provides expert guidance for Azure Dev Box. Covers troubleshooting, best practices, decision making, 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
TroubleshootingL36-L46Diagnosing and fixing Dev Box issues: connectivity/​RDC problems, custom image validation errors, stale/​inaccessible boxes, and using Azure Monitor logs for troubleshooting.
Best PracticesL47-L52Guidance on building efficient Dev Box images, including structuring image definitions and pre-warming Visual Studio caches to speed up developer environments.
Decision MakingL53-L58Guidance on planning Dev Box deployments (networking, images, capacity) and deciding or preparing to move from Dev Box to Windows 365, including design and transition considerations.
Limits & QuotasL59-L64Managing Dev Box capacity: requesting quota/​core limit increases and configuring per-user Dev Box limits to control usage and costs.
SecurityL65-L76Securing Dev Box access and sessions: RBAC roles, guest access, SSO, API auth, Key Vault/​service principals, Intune Conditional Access and Endpoint Privilege Management.
ConfigurationL77-L104Configuring Dev Box infrastructure: networks, images, catalogs, policies, schedules (stop/​hibernate/​auto-delete), monitoring, and ARM/​template-based provisioning and management.
Integrations & Coding PatternsL105-L109Using VS Code dev tunnels to securely connect to Azure Dev Box, including setup, authentication, and remote development workflow configuration.
DeploymentL110-L113Planning and rolling out Dev Box environments, including architecture and configuration, plus guidance for moving Dev Box pools and individual boxes between Azure regions.

Troubleshooting

TopicURL
Resolve common Microsoft Dev Box issues and questionshttps://learn.microsoft.com/en-us/azure/dev-box/dev-box-faq
Step-by-step guide to Dev Box connectivity issueshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-resolve-dev-box-connectivity-issues
Troubleshoot Dev Box custom image validation failureshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-custom-image-validation
Fix stale or inaccessible Dev Boxes in Task viewhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-dev-box-task-view
Troubleshoot known Dev Box connectivity problemshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-remote-desktop-connectivity
Use Troubleshoot and Repair for Dev Box RDC issueshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-troubleshoot-repair-dev-box
Monitor Dev Box with Azure Monitor diagnostic logshttps://learn.microsoft.com/en-us/azure/dev-box/monitor-dev-box

Best Practices

TopicURL
Best practices for authoring Dev Box image definitionshttps://learn.microsoft.com/en-us/azure/dev-box/concept-authoring-troubleshooting-guide-team-customizations
Pre-generate Visual Studio caches in Dev Box imageshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-generate-visual-studio-caches

Decision Making

TopicURL
Plan and design a Microsoft Dev Box deploymenthttps://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-deployment-guide
Plan transition from Dev Box to Windows 365https://learn.microsoft.com/en-us/azure/dev-box/dev-box-roadmap

Limits & Quotas

TopicURL
Request Dev Box quota and core limit increaseshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-request-quota-increase
Set per-user Dev Box limits to control costshttps://learn.microsoft.com/en-us/azure/dev-box/tutorial-dev-box-limits

Security

TopicURL
Plan Azure RBAC roles for Dev Box deploymentshttps://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-role-based-access-control
Authenticate to Dev Box REST APIs with Azure CLIhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-authenticate
Secure Dev Box tunnels with conditional access policieshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-conditional-access-dev-tunnels-service
Configure Intune Conditional Access for Dev Boxhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-intune-conditional-access-policies
Secure Dev Box customizations with Key Vault and service principalshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-customizations-connect-resource-repository
Set up Intune Endpoint Privilege Management for Dev Boxhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-elevate-privilege-dev-box
Enable single sign-on to Windows on Dev Boxeshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-enable-single-sign-on
Assign Dev Box RBAC roles for project accesshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-access

Configuration

TopicURL
Configure networking requirements for Microsoft Dev Boxhttps://learn.microsoft.com/en-us/azure/dev-box/concept-dev-box-network-requirements
Configure Dev Box auto-delete for unused environmentshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-auto-delete-dev-box
Attach and configure Azure Compute Gallery for Dev Boxhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-azure-compute-gallery
Add and manage Dev Box catalogs for image definitionshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-catalog
Configure Dev Box customization task catalogshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-customization-tasks
Configure Dev Box hibernation and scheduleshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-dev-box-hibernation
Configure imaging pipeline for Dev Box team customizationshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-dev-center-imaging
Configure Dev Box network connections and VNetshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-network-connections
Configure Dev Box project policies for governancehttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-project-policy
Set stop-on-disconnect timeout for Dev Boxeshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-stop-on-disconnect
Configure Dev Box pool autostop scheduleshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-stop-schedule
Author Dev Box image definition files for team customizationshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-team-customizations
Create and upload Dev Box user customization fileshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-configure-user-customizations
Configure virtual switches and networking in Dev Boxhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-connect-dev-box-virtual-switch
Build custom Dev Box images with Azure VM Image Builderhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-customize-devbox-azure-image-builder
Define and manage Dev Box definitionshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-definitions
Configure and manage Dev Box poolshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-pools
Manage Microsoft Dev Box projects and poolshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-box-projects
Create and manage Dev Box dev centershttps://learn.microsoft.com/en-us/azure/dev-box/how-to-manage-dev-center
Configure custom Windows images for Microsoft Dev Boxhttps://learn.microsoft.com/en-us/azure/dev-box/how-to-prepare-custom-image-dev-box
Reference for Dev Box monitoring logs and metricshttps://learn.microsoft.com/en-us/azure/dev-box/monitor-dev-box-reference
Configure core Microsoft Dev Box resourceshttps://learn.microsoft.com/en-us/azure/dev-box/quickstart-configure-dev-box-service
Configure Dev Box resources with Get Started templatehttps://learn.microsoft.com/en-us/azure/dev-box/quickstart-get-started-template
Reference schema for Dev Box imagedefinition.yaml and task.yamlhttps://learn.microsoft.com/en-us/azure/dev-box/reference-dev-box-customizations

Integrations & Coding Patterns

TopicURL
Connect to Dev Box from VS Code using dev tunnelshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-set-up-dev-tunnels

Deployment

TopicURL
Move Dev Box pools and boxes between regionshttps://learn.microsoft.com/en-us/azure/dev-box/how-to-move-dev-box-pool-region