Modify an Azure File Share - Azure Files

Summary — How to modify an Azure file share

This article describes how to change size, cost, and performance settings for Azure file shares using the Azure portal, Azure PowerShell, and Azure CLI. It covers provisioned v2, provisioned v1, and pay‑as‑you‑go (transactional) classic file shares, and also shows how to delete classic file shares.

Key points

• Interfaces supported: Azure portal, PowerShell (Update-AzRmStorageShare / Remove-AzRmStorageShare), and Azure CLI (az storage share-rm update / az storage share-rm delete). Links in the original article show exact command examples and parameters.

• Changes (storage, IOPS, throughput, access tier, quota) typically take effect within a few minutes.

• For provisioned models: you can scale storage, IOPS, and throughput; but decreases are only allowed after 24 hours have passed since the last increase.

• Pay-as-you-go model: you can change the access tier (transaction optimized, hot, cool) — switching tiers incurs transaction costs. Quota in pay-as-you-go does not affect billing but limits share size; max size is 100 TiB.

• Deleting a classic file share: can be done in portal, PowerShell, or CLI. File shares in storage accounts with soft delete enabled can be recovered within the retention period.

• Applies to many combinations of management/billing models, media tiers, and redundancy — see the original table for details and compatibility (SMB/NFS availability).

Portal — common workflows

1

Change provisioning (provisioned v2)

1. Storage account > Data storage > File shares.

2. Select the file share.

3. Select "Change size and performance".

4. Adjust Provisioned storage (GiB) and either choose Recommended provisioning or Manually specify IOPS and throughput.

5. Save.

2

Change provisioning (provisioned v1)

1. Storage account > Data storage > File shares.

2. Select the file share.

3. Select "Change size and performance".

4. Adjust Provisioned storage (GiB) — this also changes IOPS/throughput.

5. Save.

3

Change access tier or quota (pay‑as‑you‑go)

• Change access tier: Storage account > File shares > select share > "Change tier" > pick tier > Apply.

• Change quota: Storage account > File shares > select share > "Edit quota" > set value or "Set to maximum" > OK.

4

Delete a classic file share

1. Storage account > File shares.

2. Select the context menu (...) for the share > Delete share.

3. Confirm by typing the share name and Delete. Note: soft delete (if enabled) allows recovery within retention period.

PowerShell and CLI highlights

• Provisioned v2: use Update-AzRmStorageShare (PowerShell) or az storage share-rm update (CLI) to set quota, provisioned IOPS, and provisioned bandwidth (MiB/s).

• Provisioned v1: update quota (QuotaGiB) — the article includes PowerShell splatting examples and equivalent az CLI commands.

• Pay-as-you-go: Update-AzRmStorageShare or az storage share-rm update to change AccessTier and/or Quota.

• Delete: Remove-AzRmStorageShare (PowerShell) or az storage share-rm delete (CLI). (See the article for full example commands and parameter names.)

Operational notes / constraints

• Decreasing a provisioned quantity is disallowed until 24 hours after the last increase.

• Changes usually take effect in minutes.

• Changing access tiers in pay-as-you-go causes transaction costs for the movement.

• Quota behaves differently by billing model: in provisioned models quota equals provisioned storage; in pay-as-you-go it’s a limit without direct billing impact.

• Max pay-as-you-go share size: 100 TiB.

• Soft delete (if enabled) lets you recover deleted shares within the retention period.

Useful links from the article

• Learn more about Azure Files: https://docs.azure.cn/en-us/storage/files/storage-files-introduction

• Plan an Azure Files deployment: https://docs.azure.cn/en-us/storage/files/storage-files-planning

• Details on provisioning/billing and switching access tiers are linked in the original article.

Last updated: 09/30/2025

If you want, I can:

• Produce a condensed cheatsheet with the exact PowerShell and az CLI command snippets from the article.

• Extract and format the full command examples into a tabs block (PowerShell / Bash).