azure-data-box-family — Claude Code skill: what it does and setup
azure-data-box-family is a Claude Code skill that guides data transfers with Azure Data Box, Data Box Disk, and Heavy. It helps check quotas and troubleshoot SMB or REST copy issues.
CC-BY-4.0 167 installs ★ 818 updated 2026-10-25
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a claude-codeWhat azure-data-box-family does
This skill guides AI agents through migrating offline data with Azure Data Box, Data Box Disk, and Data Box Heavy devices. It covers cabling, local portal management, SMB and NFS shares, and preserving NTFS ACL permissions. It explicitly excludes Azure Import/Export, Azure Stack Edge, and Azure Virtual Machines, which rely on separate skills.
The skill pairs an index of troubleshooting topics with remote lookups. It prioritizes the mcp_microsoftdocs:microsoft_docs_fetch tool and falls back to fetch_webpage in Markdown format. Without network access, the agent cannot retrieve referenced Microsoft documentation or error code guides.
What it helps with
- preserve NTFS ACL permissions and metadata during offline Data Box migrations
- resolve Data Box Disk unlock failures and upload validation log errors
- verify storage capacity and connection quotas for Data Box Heavy
- configure disk encryption with customer-managed keys in Azure Key Vault
Example prompts for the agent
- How do I preserve NTFS ACLs when copying files to an Azure Data Box share?
- Troubleshoot this Data Box Disk unlock log and explain the validation failure.
- Check the capacity and connection limits for Azure Data Box Heavy.
How to install azure-data-box-family
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a claude-code2Manually: put the files in place
~/.claude/skills/azure-data-box-family/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-data-box-family/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a codex2Manually: put the files in place
.agents/skills/azure-data-box-family/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a cursor2Manually: put the files in place
.cursor/skills/azure-data-box-family/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-data-box-family2Manually: put the files in place
.github/skills/azure-data-box-family/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-data-box-familyManually: put the files in place
.devin/skills/azure-data-box-family/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-data-box-family
How to install azure-data-box-family in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a claude-code. The skill file is placed in ~/.claude/skills/azure-data-box-family/SKILL.md.
What does azure-data-box-family do?
It provides troubleshooting workflows, limits, security controls, and copy practices for Azure Data Box physical devices.
What dependencies does this skill require?
It requires network access to pull technical documentation. Installing the mcp_microsoftdocs MCP server is recommended for fetching articles cleanly.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-data-box-family description: Expert knowledge for Azure Data Box development including troubleshooting, best practices, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Data Box/Disk/Heavy for offline data copy, SMB/NFS uploads, REST APIs, CMKs/Key Vault, or NTFS ACL preservation, and other Azure Data Box related development tasks. Not for Azure Import Export (use azure-import-export), Azure Stack Edge (use azure-stack-edge), Azure Virtual Machines (use azure-virtual-machines). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-08-09" generator: "docs2skills/1.0.0" --- # Azure Data Box Skill This skill provides expert guidance for Azure Data Box. Covers troubleshooting, best practices, limits & quotas, security, configuration, and integrations & coding patterns. 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 | L34-L50 | Diagnosing and fixing Azure Data Box and Data Box Disk issues: audit/order logs, validation and unlock errors, SMB/REST/upload copy failures, and time sync or connection problems. | | Best Practices | L51-L56 | Guidance on preserving NTFS ACLs, file permissions, and metadata when copying data to Azure Data Box and Data Box Disk using supported tools and settings | | Limits & Quotas | L57-L66 | Limits on capacity, files, connections, and usage for Data Box, Data Box Disk, and Data Box Heavy devices, including quotas, supported configurations, and operational constraints. | | Security | L67-L77 | Securing Azure Data Box: certificates, CMKs in Key Vault, Customer Lockbox, built‑in protections, and applying Azure Policy (including regulatory controls) to Data Box and Data Box Disk. | | Configuration | L78-L97 | Configuring and operating Data Box/Heavy/Disk: cabling, system/network requirements, local UI/portal admin, SMB/NFS/NAS copy workflows, and setting blob access tiers (Hot/Cool/Archive). | | Integrations & Coding Patterns | L98-L107 | Patterns and tools for integrating Data Box with apps and backup products (REST APIs, VHD to managed disks, file share to SharePoint, Commvault, OpenText, Veeam migrations). | ### Troubleshooting | Topic | URL | |-------|-----| | Use Azure Data Box audit logs for diagnostics and security | https://learn.microsoft.com/en-us/azure/databox/data-box-audit-logs | | Use logs to resolve Azure Data Box Disk validation issues | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-troubleshoot | | Troubleshoot Azure Data Box Disk data copy problems | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-troubleshoot-data-copy | | Review and fix Azure Data Box Disk upload errors | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-troubleshoot-data-upload | | Troubleshoot Azure Data Box Disk unlock tool errors | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-troubleshoot-unlock | | Use logs to troubleshoot Azure Data Box Disk upload issues | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-troubleshoot-upload | | Track and audit Azure Data Box export orders and logs | https://learn.microsoft.com/en-us/azure/databox/data-box-export-logs | | Track and audit Azure Data Box import orders and logs | https://learn.microsoft.com/en-us/azure/databox/data-box-logs | | Troubleshoot Azure Data Box data copy errors | https://learn.microsoft.com/en-us/azure/databox/data-box-troubleshoot | | Troubleshoot Azure Data Box upload copy errors | https://learn.microsoft.com/en-us/azure/databox/data-box-troubleshoot-data-upload | | Troubleshoot Azure Data Box REST copy issues | https://learn.microsoft.com/en-us/azure/databox/data-box-troubleshoot-rest | | Fix SMB share connection failures to Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/data-box-troubleshoot-share-access | | Fix time synchronization issues on Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/data-box-troubleshoot-time-sync | ### Best Practices | Topic | URL | |-------|-----| | Preserve ACLs and metadata with Azure Data Box Disk | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-file-acls-preservation | | Preserve ACLs and metadata when copying to Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/data-box-file-acls-preservation | ### Limits & Quotas | Topic | URL | |-------|-----| | Azure Data Box Disk capacity and usage limits FAQ | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-faq | | Review Azure Data Box Disk capacity and file limits | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-limits | | Operational limits and usage details for Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/data-box-faq | | Capacity and connection limits for Azure Data Box Heavy | https://learn.microsoft.com/en-us/azure/databox/data-box-heavy-limits | | Azure Data Box device and connection limits | https://learn.microsoft.com/en-us/azure/databox/data-box-limits | | Understand Azure Data Box device capacities and usage | https://learn.microsoft.com/en-us/azure/databox/data-box-overview | ### Security | Topic | URL | |-------|-----| | Use custom certificates for Azure Data Box web UI and Blob | https://learn.microsoft.com/en-us/azure/databox/data-box-bring-your-own-certificates | | Configure Customer Lockbox approvals for Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/data-box-customer-lockbox | | Manage customer-managed keys for Azure Data Box in Key Vault | https://learn.microsoft.com/en-us/azure/databox/data-box-customer-managed-encryption-key-portal | | Security features and protections in Azure Data Box Disk | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-security | | Understand and manage Azure Data Box security features | https://learn.microsoft.com/en-us/azure/databox/data-box-security | | Apply Azure Policy built-ins to Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/policy-reference | | Apply Azure Policy regulatory controls to Data Box | https://learn.microsoft.com/en-us/azure/databox/security-controls-policy | ### Configuration | Topic | URL | |-------|-----| | Choose cabling options for Azure Data Box data transfer | https://learn.microsoft.com/en-us/azure/databox/data-box-cable-options | | Copy data to Azure Data Box via SMB with access tiers | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-copy-data | | Use Azure Data Box local copy service from NAS | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-copy-data-via-copy-service | | Copy data to Azure Data Box via NFS with access tiers | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-copy-data-via-nfs | | Copy exported data from Azure Data Box via SMB | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-export-copy-data | | Copy exported data from Azure Data Box via NFS | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-export-copy-data-via-nfs | | Copy data to Data Box Disk with access tiers | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-deploy-copy-data | | Set up and unlock Azure Data Box Disk securely | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-deploy-set-up | | System and network requirements for Azure Data Box Disk | https://learn.microsoft.com/en-us/azure/databox/data-box-disk-system-requirements | | System and network requirements for Azure Data Box Heavy | https://learn.microsoft.com/en-us/azure/databox/data-box-heavy-system-requirements | | Send Azure Data Box data to Hot, Cool, or Archive tiers | https://learn.microsoft.com/en-us/azure/databox/data-box-how-to-set-data-tier | | Configure and manage Azure Data Box using local web UI | https://learn.microsoft.com/en-us/azure/databox/data-box-local-web-ui-admin | | Administer Azure Data Box devices via Azure portal | https://learn.microsoft.com/en-us/azure/databox/data-box-portal-admin | | Administer Azure Data Box Disk via Azure portal | https://learn.microsoft.com/en-us/azure/databox/data-box-portal-ui-admin | | Review Azure Data Box system and client requirements | https://learn.microsoft.com/en-us/azure/databox/data-box-system-requirements | | Supported APIs and tools for Azure Data Box Blob storage | https://learn.microsoft.com/en-us/azure/databox/data-box-system-requirements-rest | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Migrate on-premises VHDs to Azure managed disks via Data Box | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-copy-data-from-vhds | | Use REST APIs with Azure Data Box Blob storage | https://learn.microsoft.com/en-us/azure/databox/data-box-deploy-copy-data-via-rest | | Copy data to Data Box Heavy via REST APIs | https://learn.microsoft.com/en-us/azure/databox/data-box-heavy-deploy-copy-data-via-rest | | Migrate file shares to SharePoint Online with Data Box Heavy | https://learn.microsoft.com/en-us/azure/databox/data-box-heavy-migrate-spo | | Plan migrations using Commvault Air Gap Protect with Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/migrate-commvault-data-box | | Migrate data with OpenText solutions and Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/migrate-opentext-data-box | | Migrate backups with Veeam and Azure Data Box | https://learn.microsoft.com/en-us/azure/databox/migrate-veeam-data-box |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills