Azure Files

Organization

MicrosoftDocs

azure-files

Expert knowledge for Azure Files development including best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when planning Azure File shares, File Sync tiering, NFS/SMB migrations, DR topologies, or RAG integrations, and other Azure Files related development tasks. Not for Azure Blob Storage (use azure-blob-storage), Azure NetApp Files (use azure-netapp-files), Azure Managed Lustre (use azure-managed-lustre), Azure Virtual Machines (use azure-virtual-machines).

Overview

Publisher	MicrosoftDocs
Repository	`Agent-Skills`
Skill name	`azure-files`
Stars	778
Forks	126
Bundled files	Instructions only
License	CC-BY-4.0
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
Self-contained
Everything the model needs lives in the instructions — no extra files to sync.
Open source
Published by MicrosoftDocs on GitHub. Read the source before you install it.

Installation

Install the Azure Files AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-files
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/MicrosoftDocs/Agent-Skills.git /tmp/Agent-Skills
mkdir -p .claude/skills
cp -r /tmp/Agent-Skills/skills/azure-files .claude/skills/azure-files

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Azure Files in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Azure Files on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Azure Files is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Azure Files Skill

This skill provides expert guidance for Azure Files. Covers 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

Category	Lines	Description
Best Practices	L35-L50	Best practices for Azure Files and File Sync: DR, server lifecycle and topology changes, cloud tiering, handling large NFS dirs, and tuning SMB/NFS performance for Linux and virtual desktops.
Decision Making	L51-L71	Guidance on planning Azure Files deployments: choosing share types, redundancy, billing/costs, capacity, sync/tiering, migration paths (Windows/Linux/SMB/NFS), and dev/management models.
Limits & Quotas	L72-L79	Azure Files and File Sync limits: capacity, IOPS, throughput, tiers, quotas, and API throttling behavior to plan scaling and troubleshoot performance issues.
Security	L80-L111	Securing Azure Files and File Sync: identity-based SMB/NFS auth (AD DS, Entra, Kerberos), firewalls/networking, TLS, encryption keys, NTFS ACLs, and share-level permissions.
Configuration	L112-L133	Configuring Azure Files and Azure File Sync: VPN and networking, redundancy, performance, tiering, monitoring/metrics, agent install/updates, server endpoints, and file copy operations.
Integrations & Coding Patterns	L134-L156	RAG integrations with Azure Files using Haystack, LangChain, LlamaIndex, Pinecone/Qdrant/Weaviate, plus code patterns for .NET, Java, and Python apps accessing Azure Files.
Deployment	L157-L165	Deploying Azure File Sync and migrating data to Azure Files from SMB/NFS shares, NAS, Linux servers, GlusterFS, using tools like Storage Mover, Data Box, Robocopy, portal, CLI, and PowerShell.

Best Practices

Topic	URL
Implement disaster recovery best practices for Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-disaster-recovery-best-practices
Manage Azure File Sync cloud tiering and tiered files	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-how-to-manage-tiered-files
Safely modify Azure File Sync topology	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-modify-sync-topology
Safely replace drives on Azure File Sync servers	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-drive
Replace Azure File Sync servers during lifecycle events	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-server
Safely deprovision Azure File Sync server endpoints	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-delete
Disaster recovery for Azure File Sync servers	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-recovery
Handle large directories on Azure NFS file shares	https://learn.microsoft.com/en-us/azure/storage/files/nfs-large-directories
Optimize NFS Azure file share performance on Linux	https://learn.microsoft.com/en-us/azure/storage/files/nfs-performance
Optimize performance of premium SMB Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/smb-performance
Optimize Azure Files performance for your workloads	https://learn.microsoft.com/en-us/azure/storage/files/understand-performance
Optimize Azure Files for virtual desktop workloads	https://learn.microsoft.com/en-us/azure/storage/files/virtual-desktop-workloads

Decision Making

Topic	URL
Select Azure File Sync cloud tiering policies	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-choose-cloud-tiering-policies
Plan topology and policies for Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-planning
Choose and create Azure classic file shares by tier	https://learn.microsoft.com/en-us/azure/storage/files/create-classic-file-share
Decide and create Azure file shares with Microsoft.FileShares	https://learn.microsoft.com/en-us/azure/storage/files/create-file-share
Estimate Azure Files costs across billing models	https://learn.microsoft.com/en-us/azure/storage/files/file-estimate-cost
Select Azure Files management model and resources	https://learn.microsoft.com/en-us/azure/storage/files/files-management-concepts
Choose Azure Files redundancy options for availability	https://learn.microsoft.com/en-us/azure/storage/files/files-redundancy
Choose and use Azure Files capacity reservations	https://learn.microsoft.com/en-us/azure/storage/files/files-reserve-capacity
Choose redundancy options for SSD Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/redundancy-premium-file-shares
Choose the right development approach for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-developer-overview
Choose and use Linux tools to migrate to NFS Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nfs
Select migration approaches for SMB Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-overview
Choose between Azure Files and Azure NetApp Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-netapp-comparison
Choose options for an Azure Files deployment	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-planning
Choose Azure Files billing model and manage costs	https://learn.microsoft.com/en-us/azure/storage/files/understanding-billing
Plan migration from Windows file servers to Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/windows-server-to-azure-files
Use zonal placement for SSD Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/zonal-placement

Limits & Quotas

Topic	URL
Understand Azure File Sync scalability and performance targets	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-scale-targets
Review Azure File Sync API throttling limits and behavior	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-throttling
Reference Azure Files limits, quotas, and behaviors	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-faq
Azure Files scalability and performance limits by tier	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-scale-targets

Security

Topic	URL
Configure Azure File Sync firewall and proxy settings	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-firewall-and-proxy
Configure managed identities for Azure File Sync access	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-managed-identities
Configure Azure File Sync and Files network endpoints	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-endpoints
Configure networking and access for Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-overview
Authorize Azure Files data access in portal	https://learn.microsoft.com/en-us/azure/storage/files/authorize-data-operations-portal
Enable OAuth-based REST access to Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/authorize-oauth-rest
Change identity source for Azure Files SMB authentication	https://learn.microsoft.com/en-us/azure/storage/files/change-identity-source
Configure customer-managed encryption keys for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/customer-managed-keys
Configure TLS encryption in transit for Azure NFS shares	https://learn.microsoft.com/en-us/azure/storage/files/encryption-in-transit-for-nfs-shares
Use managed identities to access Azure Files SMB	https://learn.microsoft.com/en-us/azure/storage/files/files-managed-identities
Configure network security perimeter for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/files-network-security-perimeter
Configure and secure NFS file shares in Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/files-nfs-protocol
Set up Entra Kerberos for Azure Files on macOS	https://learn.microsoft.com/en-us/azure/storage/files/identity-kerberos-authentication-macos
Configure NFS root squash for Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/nfs-root-squash
Apply security best practices to Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/secure-files
Configure identity-based authentication for Azure Files SMB	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-active-directory-overview
Configure AD DS authentication for Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-enable
Configure on-premises AD DS auth for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-overview
Rotate AD DS storage account identity password	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-update-password
Assign share-level permissions for Azure Files SMB	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-assign-share-level-permissions
Enable Microsoft Entra Domain Services auth for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-domain-services-enable
Configure cloud trust for Azure Files Kerberos access	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-cloud-trust
Enable Entra Kerberos authentication for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-identities-enable
Configure Linux Kerberos auth to Azure Files with AD DS	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-linux-kerberos-enable
Configure Linux Kerberos auth to Azure Files with Entra Domain Services	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-linux-kerberos-entra-domain-services
Configure NTFS ACLs for Azure Files over SMB	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-configure-file-level-permissions
Configure Azure Files AD DS auth across multiple forests	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-multiple-forests
Mount Azure SMB file shares securely on Linux	https://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-linux

Configuration

Topic	URL
Silently install the Azure File Sync agent	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-agent-silent-installation
Configure Azure File Sync cloud tiering date and space policies	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-cloud-tiering-policy
Configure and monitor Azure File Sync with Azure Monitor	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitoring
Track Azure File Sync agent versions and fixes	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-release-notes
Plan and execute Azure File Sync resource moves	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-resource-move
Configure Azure File Sync server endpoints and tiering	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-create
Configure and manage Azure File Sync registered servers	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-registration
Reference metrics and logs for Azure File Sync monitoring	https://learn.microsoft.com/en-us/azure/storage/file-sync/monitor-file-sync-reference
Configure and change Azure Files redundancy options	https://learn.microsoft.com/en-us/azure/storage/files/files-change-redundancy-configuration
Copy files between Azure file shares with tools	https://learn.microsoft.com/en-us/azure/storage/files/migrate-files-between-shares
Configure size and performance of Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/modify-file-share
Configure Linux point-to-site VPN for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-linux
Configure Windows point-to-site VPN to access Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-windows
Configure site-to-site VPN for on-premises access to Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-s2s-vpn
Configure Azure Monitor metrics and logs for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring
Reference monitoring metrics and logs for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring-reference
Configure DNS forwarding to Azure Files private endpoints	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-dns
Configure public and private endpoints for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-endpoints

Integrations & Coding Patterns

Topic	URL
Integrate Haystack RAG pipelines with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/haystack
Integrate LangChain RAG pipelines with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/langchain
Integrate LlamaIndex RAG pipelines with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/llamaindex
Authenticate and download Azure Files data for RAG	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/setup
Implement Haystack + Pinecone RAG over Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-pinecone/tutorial-haystack-pinecone
Implement Haystack + Qdrant RAG over Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-qdrant/tutorial-haystack-qdrant
Implement Haystack + Weaviate RAG over Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-weaviate/tutorial-haystack-weaviate
Implement Azure Files RAG with LangChain and Pinecone	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-pinecone/tutorial-langchain-pinecone
Implement Azure Files RAG with LangChain and Qdrant	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-qdrant/tutorial-langchain-qdrant
Implement Azure Files RAG with LangChain and Weaviate	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-weaviate/tutorial-langchain-weaviate
Implement Azure Files RAG with LlamaIndex and Pinecone	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/llamaindex-pinecone/tutorial-llamaindex-pinecone
Implement Azure Files RAG with LlamaIndex and Qdrant	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/llamaindex-qdrant/tutorial-llamaindex-qdrant
Implement Azure Files RAG with LlamaIndex and Weaviate	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/llamaindex-weaviate/tutorial-llamaindex-weaviate
Use Pinecone vector database with Azure Files RAG	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/vector-databases/pinecone
Use Qdrant vector database with Azure Files RAG	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/vector-databases/qdrant
Use Weaviate vector database with Azure Files RAG	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/vector-databases/weaviate
Develop .NET applications that use Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/storage-dotnet-how-to-use-files
Use Azure Files from Java applications	https://learn.microsoft.com/en-us/azure/storage/files/storage-java-how-to-use-file-storage
Use Azure Files from Python applications	https://learn.microsoft.com/en-us/azure/storage/files/storage-python-how-to-use-file-storage

Deployment

Topic	URL
Deploy Azure File Sync with portal, PowerShell, CLI	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-deployment-guide
Migrate data between Azure file shares with File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-share-to-share-migration
Migrate GlusterFS volumes to Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/glusterfs-migration-guide
Migrate SMB/NFS shares to Azure Files with Storage Mover	https://learn.microsoft.com/en-us/azure/storage/files/migrate-files-storage-mover
Migrate NAS SMB shares to Azure File Sync hybrid	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid
Migrate to SMB Azure file shares using Robocopy	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-robocopy

Frequently asked questions

What does the Azure Files AI skill do?

Why use Azure Files on TypingMind?

Because you install it once and use it with any model. Azure Files is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Azure Files in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-files. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Azure Files?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Azure Files?

As many as you like. As long as a model supports skills, you can use Azure Files with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Azure Files AI skill free?

Yes. It is published on GitHub by MicrosoftDocs under the CC-BY-4.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Architecture Decision Records

affaan-m

CommunityPopular

コーディングセッション中にアーキテクチャ決定を構造化ADRとして記録し、自動的に決定の瞬間を検出し、コンテキスト、検討された代替案、根拠を記録します。今後の開発者がコードベースの形成理由を理解するためのADRログを維持します。

Automation Audit Ops

ECC用の証拠ベースの自動化インベントリとオーバーラップ監査ワークフロー。ユーザーがどのジョブ、フック、コネクタ、MCPサーバー、またはラッパーがライブか、壊れているか、冗長であるか、修正前に不足しているかを知りたい場合に使用します。

Grok

Delegate coding to xAI Grok Build CLI (features, PRs).

Setup Wizard Generator

NousResearch

OrganizationPopular

Generate a bash wizard guiding a human through manual setup.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Azure Files Skill

How to Use This Skill

Category Index

Best Practices

Decision Making

Limits & Quotas

Security

Configuration

Integrations & Coding Patterns

Deployment

Frequently asked questions

Related AI Skills

Set up your own AI workspace now