Skip to content
cccskills
FreePublished on GitHub

azure-files

Expert knowledge for Azure Files development including best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Azure File Sync, cloud tiering, SMB/NFS shares, RAG over Azure Files, or Storage Mover/Data Box, 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).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills
Works withAzure
See how to install

Files included (1)

  • SKILL.md20.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

CategoryLinesDescription
Best PracticesL35-L50Best practices for Azure Files and File Sync: DR planning, server lifecycle changes, cloud tiering, handling large directories, and tuning SMB/NFS performance for workloads and Azure Virtual Desktop.
Decision MakingL51-L71Guidance for planning Azure Files deployments: choosing tiers, redundancy, billing, protocols (SMB/NFS), sync/topology, and migration approaches from Windows/Linux or NetApp.
Limits & QuotasL72-L79Azure Files and File Sync limits for capacity, IOPS, throughput, scalability, and API throttling behavior, to plan performance, sizing, and avoid hitting quotas.
SecurityL80-L110Securing Azure Files and Azure File Sync: identity-based auth (AD DS, Entra, Kerberos), permissions/ACLs, encryption, TLS, firewalls, networking, and secure SMB/NFS access.
ConfigurationL111-L135Configuring Azure Files and Azure File Sync: VPN connectivity, endpoints/DNS, redundancy and performance, cloud tiering, monitoring/metrics/logs, alerts, and file copy/change feed.
Integrations & Coding PatternsL136-L158RAG integrations with Azure Files using Haystack, LangChain, LlamaIndex, Pinecone/Qdrant/Weaviate, plus code patterns for .NET, Java, and Python apps accessing Azure Files.
DeploymentL159-L167Deploying 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

TopicURL
Implement disaster recovery best practices for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-disaster-recovery-best-practices
Manage Azure File Sync cloud tiering and tiered fileshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-how-to-manage-tiered-files
Safely modify Azure File Sync topologyhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-modify-sync-topology
Safely replace drives on Azure File Sync servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-drive
Replace Azure File Sync servers during lifecycle eventshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-server
Safely deprovision Azure File Sync server endpointshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-delete
Disaster recovery for Azure File Sync servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-recovery
Handle large directories on Azure NFS file shareshttps://learn.microsoft.com/en-us/azure/storage/files/nfs-large-directories
Improve NFS Azure Files performance on Linux clientshttps://learn.microsoft.com/en-us/azure/storage/files/nfs-performance
Tune SMB Azure Files performance on premium SSDhttps://learn.microsoft.com/en-us/azure/storage/files/smb-performance
Optimize Azure Files performance for specific workloadshttps://learn.microsoft.com/en-us/azure/storage/files/understand-performance
Use Azure Files for Azure Virtual Desktop profileshttps://learn.microsoft.com/en-us/azure/storage/files/virtual-desktop-workloads

Decision Making

TopicURL
Select Azure File Sync cloud tiering policieshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-choose-cloud-tiering-policies
Plan topology and policies for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-planning
Choose and create Azure classic file shares by tierhttps://learn.microsoft.com/en-us/azure/storage/files/create-classic-file-share
Estimate Azure Files costs across billing modelshttps://learn.microsoft.com/en-us/azure/storage/files/file-estimate-cost
Choose Azure Files management model and resource providerhttps://learn.microsoft.com/en-us/azure/storage/files/files-management-concepts
Select and configure NFS protocol for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/files-nfs-protocol
Choose Azure Files redundancy options for availabilityhttps://learn.microsoft.com/en-us/azure/storage/files/files-redundancy
Choose and use Azure Files capacity reservationshttps://learn.microsoft.com/en-us/azure/storage/files/files-reserve-capacity
Choose redundancy options for SSD Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/redundancy-premium-file-shares
Choose development approaches with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-developer-overview
Choose and use Linux tools to migrate to NFS Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nfs
Select migration approaches for SMB Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-overview
Choose between Azure Files and Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-netapp-comparison
Choose options for an Azure Files deploymenthttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-planning
Choose Azure Files billing model and manage costshttps://learn.microsoft.com/en-us/azure/storage/files/understanding-billing
Plan migration from Windows file servers to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/windows-server-to-azure-files
Use zonal placement for SSD Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/zonal-placement

Limits & Quotas

TopicURL
Understand Azure File Sync scalability and performance targetshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-scale-targets
Review Azure File Sync API throttling limits and behaviorhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-throttling
Reference Azure Files limits, quotas, and behaviorshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-faq
Azure Files scalability, IOPS, and throughput limitshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-scale-targets

Security

TopicURL
Configure Azure File Sync firewall and proxy settingshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-firewall-and-proxy
Configure managed identities for Azure File Sync accesshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-managed-identities
Configure Azure File Sync and Files network endpointshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-endpoints
Configure networking and access for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-overview
Authorize Azure Files data access in portalhttps://learn.microsoft.com/en-us/azure/storage/files/authorize-data-operations-portal
Enable OAuth-based REST access to Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/authorize-oauth-rest
Change identity source for Azure Files SMB authenticationhttps://learn.microsoft.com/en-us/azure/storage/files/change-identity-source
Configure customer-managed encryption keys for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/customer-managed-keys
Configure TLS encryption in transit for Azure NFS shareshttps://learn.microsoft.com/en-us/azure/storage/files/encryption-in-transit-for-nfs-shares
Use managed identities to access Azure Files SMBhttps://learn.microsoft.com/en-us/azure/storage/files/files-managed-identities
Configure network security perimeter for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/files-network-security-perimeter
Set up Entra Kerberos for Azure Files on macOShttps://learn.microsoft.com/en-us/azure/storage/files/identity-kerberos-authentication-macos
Configure NFS root squash for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/nfs-root-squash
Apply security controls for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/secure-files
Configure identity-based authentication for Azure Files SMBhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-active-directory-overview
Configure AD DS authentication for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-enable
Configure on-premises AD DS auth for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-overview
Rotate AD DS storage account identity passwordhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-update-password
Assign share-level permissions for Azure Files SMBhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-assign-share-level-permissions
Enable Microsoft Entra Domain Services auth for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-domain-services-enable
Configure cloud trust for Azure Files Kerberos accesshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-cloud-trust
Enable Entra Kerberos authentication for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-identities-enable
Configure Linux Kerberos auth to Azure Files with AD DShttps://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 Serviceshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-linux-kerberos-entra-domain-services
Configure NTFS ACLs for Azure Files over SMBhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-configure-file-level-permissions
Configure Azure Files AD DS auth across multiple forestshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-multiple-forests
Mount Azure SMB file shares securely on Linuxhttps://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-linux

Configuration

TopicURL
Silently install the Azure File Sync agenthttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-agent-silent-installation
Configure Azure File Sync cloud tiering date and space policieshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-cloud-tiering-policy
Configure and monitor Azure File Sync with Azure Monitorhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitoring
Track Azure File Sync agent versions and fixeshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-release-notes
Plan and execute Azure File Sync resource moveshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-resource-move
Configure Azure File Sync server endpoints and tieringhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-create
Configure and manage Azure File Sync registered servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-registration
Reference metrics and logs for Azure File Sync monitoringhttps://learn.microsoft.com/en-us/azure/storage/file-sync/monitor-file-sync-reference
Configure Azure Monitor metrics for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/analyze-files-metrics
Configure and change Azure Files redundancy optionshttps://learn.microsoft.com/en-us/azure/storage/files/files-change-redundancy-configuration
Create Azure Monitor alerts for Azure Files issueshttps://learn.microsoft.com/en-us/azure/storage/files/files-monitoring-alerts
Copy files between Azure file shares with toolshttps://learn.microsoft.com/en-us/azure/storage/files/migrate-files-between-shares
Configure size and performance of Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/modify-file-share
Configure and consume Azure Files change feed (preview)https://learn.microsoft.com/en-us/azure/storage/files/storage-files-change-feed
Configure Linux point-to-site VPN for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-linux
Configure Windows point-to-site VPN to access Azure Fileshttps://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 Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-s2s-vpn
Configure Azure Monitor metrics and logs for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring
Reference monitoring metrics and logs for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring-reference
Configure DNS forwarding to Azure Files private endpointshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-dns
Configure public and private endpoints for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-endpoints

Integrations & Coding Patterns

TopicURL
Integrate Haystack RAG pipelines with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/haystack
Integrate LangChain RAG pipelines with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/langchain
Integrate LlamaIndex RAG pipelines with Azure Fileshttps://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 RAGhttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/setup
Implement Haystack + Pinecone RAG over Azure Fileshttps://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 Fileshttps://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 Fileshttps://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 Pineconehttps://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 Qdranthttps://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 Weaviatehttps://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 Pineconehttps://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 Qdranthttps://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 Weaviatehttps://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 RAGhttps://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 RAGhttps://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 RAGhttps://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 Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-dotnet-how-to-use-files
Use Azure Files from Java applicationshttps://learn.microsoft.com/en-us/azure/storage/files/storage-java-how-to-use-file-storage
Use Azure Files from Python applicationshttps://learn.microsoft.com/en-us/azure/storage/files/storage-python-how-to-use-file-storage

Deployment

TopicURL
Deploy Azure File Sync with portal, PowerShell, CLIhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-deployment-guide
Migrate data between Azure file shares with File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-share-to-share-migration
Migrate GlusterFS volumes to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/glusterfs-migration-guide
Migrate SMB/NFS shares to Azure Files with Storage Moverhttps://learn.microsoft.com/en-us/azure/storage/files/migrate-files-storage-mover
Migrate NAS SMB shares to Azure File Sync hybridhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid
Migrate to SMB Azure file shares using Robocopyhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-robocopy

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-anyscale-on-azure

Free

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill