azure-files

Expert knowledge for Azure Files development including best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Azure Files applications. Not for Azure Blob Storage (use azure-blob-storage), Azure NetApp Files (use azure-netapp-files), Azure Table Storage (use azure-table-storage), Azure Queue Storage (use azure-queue-storage).

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "azure-files" with this command: npx skills add microsoftdocs/agent-skills/microsoftdocs-agent-skills-azure-files

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: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question

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 Azure File Sync: DR/failover planning, server/drive replacement and recovery, safe deprovisioning, and performance tuning (SMB, NFS, Linux, VDI/FSLogix).
Decision MakingL51-L70Guidance for planning Azure Files deployments: choosing tiers, redundancy, billing, costs, migration paths (SMB/NFS), File Sync topologies, and when to use Azure Files vs alternatives.
Limits & QuotasL71-L79Azure Files/File Sync limits: capacity, IOPS/throughput, scalability targets, API throttling behavior, redundancy/region support, and FAQ on performance-related constraints.
SecurityL80-L104Securing Azure Files: identity-based SMB/NFS auth (AD DS, Entra, Kerberos), NTFS/share permissions, encryption in transit, network/firewall config, and managed identity access.
ConfigurationL105-L135Configuring Azure Files and File Sync: networking, VPN, endpoints, security, redundancy, monitoring/alerts, cloud tiering, and mounting shares on Windows, Linux, and macOS.
Integrations & Coding PatternsL136-L143Using Azure Files from code: AKS CSI integration and .NET, Java, Python SDK usage, including auth, file operations, and app integration patterns.
DeploymentL144-L155Guides for deploying and migrating to Azure Files/Azure File Sync from NAS, Linux, GlusterFS, SMB/NFS shares, using tools like Data Box, Storage Mover, and Robocopy, plus moving File Sync resources.

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
Modify Azure File Sync topology without data losshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-modify-sync-topology
Replace drives on Azure File Sync servers correctlyhttps://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
Deprovision Azure File Sync server endpoints safelyhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-delete
Recover Azure File Sync servers after failureshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-recovery
Plan disaster recovery and failover for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/files-disaster-recovery
Handle large directories on Azure Files with Linuxhttps://learn.microsoft.com/en-us/azure/storage/files/nfs-large-directories
Tune NFS Azure file share performance at scalehttps://learn.microsoft.com/en-us/azure/storage/files/nfs-performance
Improve performance of SMB premium Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/smb-performance
Optimize Azure Files performance for workloadshttps://learn.microsoft.com/en-us/azure/storage/files/understand-performance
Use Azure Files for virtual desktop and FSLogix profileshttps://learn.microsoft.com/en-us/azure/storage/files/virtual-desktop-workloads

Decision Making

TopicURL
Select optimal Azure File Sync cloud tiering policieshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-choose-cloud-tiering-policies
Plan Azure File Sync deployment options and topologyhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-planning
Choose and configure Azure File Sync server endpointshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-create
Create Azure classic file shares with right tierhttps://learn.microsoft.com/en-us/azure/storage/files/create-classic-file-share
Decide when to use Microsoft.FileShares providerhttps://learn.microsoft.com/en-us/azure/storage/files/create-file-share
Estimate Azure Files costs across billing modelshttps://learn.microsoft.com/en-us/azure/storage/files/file-estimate-cost
Use and plan NFS Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/files-nfs-protocol
Choose Azure Files redundancy options for workloadshttps://learn.microsoft.com/en-us/azure/storage/files/files-redundancy
Reduce Azure Files costs using reservationshttps://learn.microsoft.com/en-us/azure/storage/files/files-reserve-capacity
Choose application development approaches with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-developer-overview
Migrate Linux servers to NFS Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nfs
Choose migration approach for SMB Azure Fileshttps://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
Plan Azure Files deployment and access modelhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-planning
Understand and choose Azure Files billing modelshttps://learn.microsoft.com/en-us/azure/storage/files/understanding-billing
Replace Windows file servers with Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/files/windows-server-to-azure-files

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
Check redundancy region support for SSD Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/redundancy-premium-file-shares
Azure Files and File Sync FAQ with limits 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 on-premises firewall and proxy for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-firewall-and-proxy
Use managed identities to secure Azure File Sync accesshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-managed-identities
Authorize Azure Files portal access with Entra or keyshttps://learn.microsoft.com/en-us/azure/storage/files/authorize-data-operations-portal
Enable OAuth-based REST access to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/authorize-oauth-rest
Encrypt data in transit for NFS Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/encryption-in-transit-for-nfs-shares
Configure managed identity access to SMB Azure file shareshttps://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
Disable insecure SMB1 on Linux for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/files-remove-smb1-linux
Configure root squash security for NFS Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/nfs-root-squash
Overview of identity-based SMB auth for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-active-directory-overview
Configure authorization and access control for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-authorization-overview
Enable AD DS authentication for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-enable
Configure on-prem 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 file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-assign-share-level-permissions
Use Entra Domain Services auth with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-domain-services-enable
Configure cloud trust between AD DS and Entra IDhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-cloud-trust
Configure Entra Kerberos auth for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-identities-enable
Enable Kerberos auth for Linux SMB Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-linux-kerberos-enable
Configure NTFS ACLs for Azure Files SMB accesshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-configure-file-level-permissions
Configure Azure Files with multiple AD DS forestshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-multiple-forests

Configuration

TopicURL
Silently install Azure File Sync agent with custom settingshttps://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
Install and manage Azure File Sync agent on Arc servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-extension
Manage Azure File Sync cloud tiered files via PowerShellhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-how-to-manage-tiered-files
Monitor Azure File Sync cloud tiering metrics and cachehttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitor-cloud-tiering
Configure Azure Monitor for Azure File Sync monitoring and alertshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitoring
Configure public and private endpoints for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-endpoints
Configure networking for Azure File Sync caching servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-overview
Reference metrics and logs for monitoring Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/monitor-file-sync-reference
Analyze Azure Files performance metrics in Azure Monitorhttps://learn.microsoft.com/en-us/azure/storage/files/analyze-files-metrics
Change redundancy configuration for Azure Files accountshttps://learn.microsoft.com/en-us/azure/storage/files/files-change-redundancy-configuration
Create Azure Monitor alerts for Azure Files healthhttps://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 Linux P2S VPN access to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-linux
Configure Windows P2S VPN access to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-windows
Configure site-to-site VPN for Azure Files accesshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-s2s-vpn
Mount NFS Azure file shares on Linuxhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-how-to-mount-nfs-shares
Configure Azure Monitor for Azure Files metrics and logshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring
Reference for Azure Files monitoring metrics and logshttps://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
Configure networking and security for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-overview
Configure and use Azure Files soft deletehttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-prevent-file-share-deletion
Mount SMB Azure file shares on Linux securelyhttps://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-linux
Mount Azure file shares over SMB on macOShttps://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-mac
Mount SMB Azure file shares on Windowshttps://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-windows
Configure zonal placement for SSD Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/zonal-placement

Integrations & Coding Patterns

Deployment

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Security

azure-security

No summary provided by upstream source.

Repository SourceNeeds Review
Automation

azure-architecture

No summary provided by upstream source.

Repository SourceNeeds Review
Automation

azure-logic-apps

No summary provided by upstream source.

Repository SourceNeeds Review
Automation

azure-blob-storage

No summary provided by upstream source.

Repository SourceNeeds Review