Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-data-box-family -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/azure-data-box-family/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-data-box-family/

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-playwright-workspaces azure-playwright-workspaces guides Playwright Testing workspace setup, RBAC permissions, quota management, and test failure troubleshooting. CX Codex +1 168installs azure-vm-scalesets azure-vm-scalesets is a skill for Azure Virtual Machine Scale Sets, covering autoscale troubleshooting, security, and deployment. It supports scale set design and configuration. CX Codex +1 168installs azure-energy-data-services Guides Azure Energy Data Services development. It covers ADME security, DDMS API calls, configuration, deployment, and manifest-ingestion failures. CX Codex +1 167installs azure-health-bot Hands the agent a reference on Azure Health Bot: auth providers, Teams and web chat channels, telemetry, voice safeguards. Live documentation pages come from Microsoft Learn. CX Codex +1 167installs azure-internet-peering Guides Azure Internet Peering checks and troubleshooting for Peering Service prefixes, registration, routing, and reachability issues. CX Codex +1 167installs azure-managed-lustre The skill gives the agent expert knowledge of Azure Managed Lustre: cluster sizing, Blob integration, AKS setup, CMK encryption, performance troubleshooting. CX Codex +1 166installs azure-video-indexer azure-video-indexer guides agents on Azure AI Video Indexer development, live camera insights, speech models, security, and API integrations. CX Codex +1 166installs azure-extended-zones This skill guides Azure Extended Zones work with quotas, security, and configuration. Use it for subscription access, policy, firewall, and disk encryption tasks. CX Codex +1 166installs

Project sponsors

Companies that keep this analytics open