You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/storage/files/smb-performance.md
+26-5Lines changed: 26 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Learn about ways to improve performance and throughput for SSD (pre
4
4
author: khdownie
5
5
ms.service: azure-file-storage
6
6
ms.topic: concept-article
7
-
ms.date: 01/22/2025
7
+
ms.date: 05/29/2025
8
8
ms.author: kendownie
9
9
ms.custom: references_regions
10
10
---
@@ -163,9 +163,9 @@ This feature improves the following metadata APIs and can be used from both Wind
163
163
- Close
164
164
- Delete
165
165
166
-
Currently this feature is only available for SSD file shares. There are no extra costs associated with using this feature.
166
+
Currently this feature is only available for SSD file shares. There are no extra costs associated with using this feature. You can also register to increase file handle limits for SSD file shares (preview).
167
167
168
-
### Register for the feature
168
+
### Register for the metadata caching feature
169
169
170
170
To get started, register for the feature using the Azure portal or Azure PowerShell.
### Register for increased file handle limits (preview)
190
+
191
+
To increase the maximum number of concurrent handles per file and directory for SSD SMB file shares from 2,000 to 10,000, register for the preview feature using the Azure portal or Azure PowerShell. If you have questions, email [email protected].
192
+
193
+
# [Azure portal](#tab/portal)
194
+
195
+
1. Sign in to the [Azure portal](https://portal.azure.com?azure-portal=true).
196
+
2. Search for and select **Preview features**.
197
+
3. Select the **Type** filter and select **Microsoft.Storage**.
198
+
4. Select **Azure Premium Files Increased Maximum Opened Handles Count** and then select **Register**.
199
+
200
+
# [Azure PowerShell](#tab/powershell)
201
+
202
+
To register your subscription using Azure PowerShell, run the following commands. Replace `<your-subscription-id>` and `<your-tenant-id>` with your own values.
| Maximum concurrent handles for root directory | 10,000 handles | 10,000 handles | 10,000 handles |
124
-
| Maximum concurrent handles per file and directory | 2,000 handles | 2,000 handles | 2,000 handles |
124
+
| Maximum concurrent handles per file and directory | 2,000 handles\*| 2,000 handles | 2,000 handles |
125
+
126
+
\* The maximum number of concurrent handles per file and directory is a soft limit for SSD SMB file shares. If you need to scale beyond this limit, you can [enable metadata caching](smb-performance.md#register-for-the-metadata-caching-feature), and register for [increased file handle limits (preview)](smb-performance.md#register-for-increased-file-handle-limits-preview).
125
127
126
128
### Azure Files sizing guidance for Azure Virtual Desktop
@@ -41,6 +48,8 @@ Azure Files offers different billing models, including provisioned and pay-as-yo
41
48
42
49
While Azure Files can support thousands of concurrent virtual desktop users from a single file share, it's critical to properly test your workloads against the size and type of file share you're using. Your requirements might vary based on number of users and profile size.
43
50
51
+
Virtual desktops with home directories or other workloads that are primarily interacting with many small files, directories, or handles can benefit from [metadata caching](smb-performance.md#metadata-caching-for-ssd-file-shares) on SSD file shares.
52
+
44
53
The following table lists our general recommendations based on the number of concurrent users. This table is based on the assumption that the user profile has a capacity of 5 GiB and a performance of 50 IOPS during sign in and 20 IOPS during steady state.
45
54
46
55
|**Number of virtual desktop users**|**Recommended file storage**|
@@ -52,7 +61,10 @@ The following table lists our general recommendations based on the number of con
52
61
53
62
## Azure Files sizing guidance for Azure Virtual Desktop
54
63
55
-
In large scale Azure Virtual Desktop deployments, you might run out of handles if you're using a single Azure file share. This section describes how various types of disk images consume handles and provides sizing guidance based on the technology you're using.
64
+
In large-scale VDI environments, tens of thousands of users may need to access the same file simultaneously, especially during application launches and session setups. In these situations, you might run out of handles, especially if you're using a single Azure file share. This section describes how various types of disk images consume handles and provides sizing guidance based on the technology you're using.
65
+
66
+
> [!TIP]
67
+
> Historically, Azure Files had a 2,000 concurrent handle limit per file and directory. If you need to scale beyond this limit, you can use SSD file shares, [enable metadata caching](smb-performance.md#register-for-the-metadata-caching-feature), and register for [increased file handle limits (preview)](smb-performance.md#register-for-increased-file-handle-limits-preview).
0 commit comments