Skip to content

Commit b1639f1

Browse files
Merge pull request #262578 from khdownie/patch-1
Update storage-how-to-use-files-windows.md
2 parents 4550a84 + af04dda commit b1639f1

1 file changed

Lines changed: 24 additions & 11 deletions

File tree

articles/storage/files/storage-how-to-use-files-windows.md

Lines changed: 24 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,23 @@ description: Learn to use Azure file shares with Windows and Windows Server. Use
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.topic: how-to
7-
ms.date: 05/02/2023
7+
ms.date: 01/05/2024
88
ms.author: kendownie
99
ms.custom: ai-video-demo
1010
ai-usage: ai-assisted
1111
---
1212

1313
# Mount SMB Azure file share on Windows
14-
[Azure Files](storage-files-introduction.md) is Microsoft's easy-to-use cloud file system. Azure file shares can be seamlessly used in Windows and Windows Server. This article discusses the considerations for using an Azure file share with Windows and Windows Server.
14+
15+
[Azure Files](storage-files-introduction.md) is Microsoft's easy-to-use cloud file system. Azure file shares can be seamlessly used in Windows and Windows Server. This article shows you how to use an Azure file share with Windows and Windows Server.
16+
17+
## Applies to
18+
19+
| File share type | SMB | NFS |
20+
|-|:-:|:-:|
21+
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
22+
| Standard file shares (GPv2), GRS/GZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
23+
| Premium file shares (FileStorage), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
1524

1625
This video shows you how to mount an SMB Azure file share on Windows.
1726
> [!VIDEO c057ece1-3ba7-409b-8cee-5492a4ad4ee4]
@@ -48,26 +57,21 @@ In order to use an Azure file share via the public endpoint outside of the Azure
4857
> [!Note]
4958
> We always recommend taking the most recent KB for your version of Windows.
5059
51-
## Applies to
52-
| File share type | SMB | NFS |
53-
|-|:-:|:-:|
54-
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
55-
| Standard file shares (GPv2), GRS/GZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
56-
| Premium file shares (FileStorage), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
60+
## Prerequisites
5761

58-
## Prerequisites
5962
Ensure port 445 is open: The SMB protocol requires TCP port 445 to be open. Connections will fail if port 445 is blocked. You can check if your firewall or ISP is blocking port 445 by using the `Test-NetConnection` cmdlet. See [Port 445 is blocked](/troubleshoot/azure/azure-storage/files-troubleshoot-smb-connectivity?toc=/azure/storage/files/toc.json#cause-1-port-445-is-blocked).
6063

6164
## Using an Azure file share with Windows
65+
6266
To use an Azure file share with Windows, you must either mount it, which means assigning it a drive letter or mount point path, or [access it via its UNC path](#access-an-azure-file-share-via-its-unc-path).
6367

64-
This article uses the storage account key to access the file share. A storage account key is an administrator key for a storage account, including administrator permissions to all files and folders within the file share you're accessing, and for all file shares and other storage resources (blobs, queues, tables, etc.) contained within your storage account. If this isn't sufficient for your workload, you can use [Azure File Sync](../file-sync/file-sync-planning.md) or [identity-based authentication over SMB](storage-files-active-directory-overview.md).
68+
This article uses the storage account key to access the file share. A storage account key is an administrator key for a storage account, including administrator permissions to all files and folders within the file share you're accessing, and for all file shares and other storage resources (blobs, queues, tables, etc.) contained within your storage account. If this isn't sufficient for your workload, you can use [Azure File Sync](../file-sync/file-sync-planning.md) or [identity-based authentication over SMB](storage-files-active-directory-overview.md). Shared access signature (SAS) tokens aren't currently supported for mounting Azure file shares.
6569

6670
A common pattern for lifting and shifting line-of-business (LOB) applications that expect an SMB file share to Azure is to use an Azure file share as an alternative for running a dedicated Windows file server in an Azure VM. One important consideration for successfully migrating an LOB application to use an Azure file share is that many applications run under the context of a dedicated service account with limited system permissions rather than the VM's administrative account. Therefore, you must ensure that you mount/save the credentials for the Azure file share from the context of the service account rather than your administrative account.
6771

6872
### Mount the Azure file share
6973

70-
The Azure portal provides a script that you can use to mount your file share directly to a host. We recommend using this provided script.
74+
The Azure portal provides a script that you can use to mount your file share directly to a host using the storage account key. We recommend using this provided script.
7175

7276
To get this script:
7377

@@ -92,6 +96,7 @@ To get this script:
9296
You have now mounted your Azure file share.
9397

9498
### Mount the Azure file share with File Explorer
99+
95100
> [!Note]
96101
> Note that the following instructions are shown on Windows 10 and may differ slightly on older releases.
97102
@@ -116,6 +121,7 @@ You have now mounted your Azure file share.
116121
1. When you're ready to dismount the Azure file share, right-click on the entry for the share under the **Network locations** in File Explorer and select **Disconnect**.
117122

118123
### Access an Azure file share via its UNC path
124+
119125
You don't need to mount the Azure file share to a particular drive letter to use it. You can directly access your Azure file share using the [UNC path](/windows/win32/fileio/naming-a-file) by entering the following into File Explorer. Be sure to replace *storageaccountname* with your storage account name and *myfileshare* with your file share name:
120126

121127
`\\storageaccountname.file.core.windows.net\myfileshare`
@@ -129,9 +135,11 @@ For Azure Government Cloud, simply change the servername to:
129135
`\\storageaccountname.file.core.usgovcloudapi.net\myfileshare`
130136

131137
### Accessing share snapshots from Windows
138+
132139
If you've taken a share snapshot, either manually or automatically through a script or service like Azure Backup, you can view previous versions of a share, a directory, or a particular file from a file share on Windows. You can take a share snapshot using the [Azure portal](storage-files-quick-create-use-windows.md#create-a-share-snapshot), [Azure PowerShell](/powershell/module/az.storage/new-azrmstorageshare), or [Azure CLI](/cli/azure/storage/share#az-storage-share-snapshot).
133140

134141
#### List previous versions
142+
135143
Browse to the item or parent item that needs to be restored. Double-click to go to the desired directory. Right-click and select **Properties** from the menu.
136144

137145
![Right-click menu for a selected directory](./media/storage-how-to-use-files-windows/snapshot-windows-previous-versions.png)
@@ -145,14 +153,17 @@ You can select **Open** to open a particular snapshot.
145153
![Opened snapshot](./media/storage-how-to-use-files-windows/snapshot-browse-windows.png)
146154

147155
#### Restore from a previous version
156+
148157
Select **Restore** to copy the contents of the entire directory recursively at the share snapshot creation time to the original location.
149158

150159
![Restore button in warning message](./media/storage-how-to-use-files-windows/snapshot-windows-restore.png)
151160

152161
## Enable SMB Multichannel
162+
153163
Support for SMB Multichannel in Azure Files requires ensuring Windows has all the relevant patches applied to be up-to-date. Several older Windows versions, including Windows Server 2016, Windows 10 version 1607, and Windows 10 version 1507, require additional registry keys to be set for all relevant SMB Multichannel fixes to be applied on fully patched installations. If you're running a version of Windows that is newer than these three versions, no additional action is required.
154164

155165
### Windows Server 2016 and Windows 10 version 1607
166+
156167
To enable all SMB Multichannel fixes for Windows Server 2016 and Windows 10 version 1607, run the following PowerShell command:
157168

158169
```PowerShell
@@ -164,6 +175,7 @@ Set-ItemProperty `
164175
```
165176

166177
### Windows 10 version 1507
178+
167179
To enable all SMB Multichannel fixes for Windows 10 version 1507, run the following PowerShell command:
168180

169181
```PowerShell
@@ -175,6 +187,7 @@ Set-ItemProperty `
175187
```
176188

177189
## Next steps
190+
178191
See these links for more information about Azure Files:
179192
- [Planning for an Azure Files deployment](storage-files-planning.md)
180193
- [FAQ](storage-files-faq.md)

0 commit comments

Comments
 (0)