Create an Azure file share with Microsoft.FileShares (preview)

To create a file share via the Azure portal, use the search box at the top of the Azure portal to search for file share and select the matching result.

Select + Create to create a new file share.

Basics

The first tab to complete creating a file share is labeled Basics, which contains the required fields to create a file share.

Advanced

The Advanced tab is optional and provides more granular settings. You can choose to set up root squash options or specify a mount name for the file share. Mount name allows you to choose a different name to use to mount the file share. By default, it's the same as the file share name. Customize it if you want a unique mount name. The same rules still apply to the naming policy. See Naming rules and restrictions for Azure resources.

Networking

Using the NFS protocol for a file share requires network-level security configurations. Currently there are two options for establishing networking-level security configurations: Private endpoint and service endpoint. Private endpoint gives your file share a private, static IP address within your virtual network, preventing connectivity interruptions from dynamic IP address changes. Traffic to your file share stays within peered virtual networks, including those in other regions and on premises. See What is a private endpoint to learn more.

If you don't require a static IP address, you can enable a service endpoint for Azure Files within the virtual network. A service endpoint configures file share to allow access only from specific subnets. The allowed subnets can belong to a virtual network in the same subscription or a different subscription, including those that belong to a different Microsoft Entra tenant. There's no extra charge for using service endpoints. See Azure virtual network service endpoints to learn more.

The Networking tab is optional, and allows you to set up both service and private endpoint. A virtual network is required if you intend to set up private endpoint while creating the file share. You may also set up networking configurations after the file share is created.

With public endpoints access enabled, you can create or choose an existing virtual network for the service endpoint connection to this file share. If you decide to disable public endpoint access, service endpoint will be disabled for this specific file share.

For private endpoint configurations, each file share will have its own private endpoint. To get started, follow these steps.

1. Select + Create private endpoint. Leave Subscription and Resource group the same. Choose the same location as the virtual network and desired name for the private endpoint. Choose FileShare for storage sub-resource.
2. Under networking section, choose the desired virtual network and subnet setting. Select Yes for Integrate with private DNS zone.
3. Select OK.

Tags

Tags are name/value pairs that enable you to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups. These are optional, and you can apply them after you create the file share.

Review + create

The final step to create the file share is to select the Create button on the Review + create tab. This button isn't available until you complete all the required fields.

To create a file share via PowerShell, run this command.

New-AzResource -ResourceType "Microsoft.FileShares/fileShares" `
               -ResourceName "<your-file-share-name>" `
               -Location "<intended-region-for-deployment>" `
               -ResourceGroupName "<your-resource-group-name>" `
               -Properties @{
                   # redundancy support "Local" and "Zone"
                   redundancy = "Local"
                   protocol = "NFS"
                   provisionedStorageGiB = <intended capacity>
                   ProvisionedIoPerSec = <intended IOPS> 
                   ProvisionedThroughputMiBPerSec = <intended throughput>
                   mediaTier = "SSD"
                   # optional: mountName = "<mount-name-for-file-share>"
                   nfsProtocolProperties = @{
                       rootSquash = "RootSquash"
                   }
               } `
               -Force

To create a file share via Azure CLI, run this command.

az resource create \
  --resource-type "Microsoft.FileShares/fileShares" \
  --name <your-file-share-name> \
  --location <intended-region-for-deployment> \
  --resource-group <your-resource-group-name> \
  --properties '{
    # redundancy support "Local" and "Zone"
    "redundancy": "Local",
    "protocol": "NFS",
    "provisionedStorageGiB": <intended capacity>,
    "ProvisionedIoPerSec": <intended IOPS>,
    "ProvisionedThroughputMiBPerSec": <intended throughput,
    "mediaTier": "SSD",
    "nfsProtocolProperties": {
      "rootSquash": "RootSquash"
    }
}'