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/migrate-files-between-shares.md
+22-12Lines changed: 22 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,33 +1,44 @@
1
1
---
2
2
title: Copy Files Between Azure File Shares
3
-
description: Learn how to copy files from one Azure file share to another using common copy tools such as AzCopy and RoboCopy.
3
+
description: Learn how to copy files from one Azure file share to another using common copy tools such as AzCopy and Robocopy.
4
4
ms.service: azure-file-storage
5
5
ms.topic: how-to
6
-
ms.date: 01/27/2026
6
+
ms.date: 01/30/2026
7
7
ms.author: kendownie
8
8
author: khdownie
9
9
# Customer intent: As a cloud administrator, I want to copy files between Azure file shares so that I can efficiently transition data with minimal downtime and optimize storage performance.
10
10
---
11
11
12
12
# Copy files from one Azure file share to another
13
13
14
-
This article describes how to copy files between Azure file shares using common copy tools. You can copy files between HDD and SSD file shares, file shares using a different billing model, or file shares in different Azure regions.
14
+
This article describes how to copy files between Azure file shares using common copy tools. You can copy files between HDD and SSD file shares, file shares using a different billing model, or file shares in different Azure regions.
15
15
16
-
> [!WARNING]
17
-
> If you're using Azure File Sync, the copy process is different than described in this article. See [Copy files from one Azure file share to another when using Azure File Sync](../file-sync/file-sync-share-to-share-migration.md).
16
+
This article doesn't provide guidance for migrations to Azure Files. If you want to migrate to Azure Files, see [Migrate to SMB Azure file shares](storage-files-migration-overview.md) or [Migrate to NFS Azure file shares](storage-files-migration-nfs.md). If you're using Azure File Sync and you want to migrate between Azure file shares, see [Migrate files from one Azure file share to another when using Azure File Sync](../file-sync/file-sync-share-to-share-migration.md).
18
17
19
-
## Choose a copy tool
18
+
## Choose a file copy tool
20
19
21
-
This article covers two tools for copying files between Azure file shares: AzCopy and RoboCopy.
20
+
The file copy tool you should choose depends on whether you want to copy files between SMB file shares or NFS file shares. The following table lists the various copy tools available, and their compatibility.
22
21
23
-
**AzCopy** is generally recommended because it uses server-to-server APIs, meaning data is copied directly between storage servers without passing through a local machine. This provides better performance and avoids the need to provision a VM. AzCopy also works with both SMB and NFS file shares and can be run from Windows, Linux, or macOS. If you need to copy files between NFS shares, choose AzCopy.
24
-
25
-
**RoboCopy** is a Windows command-line utility that uses the SMB protocol for file copy operations. It requires mounting both file shares to a Windows VM. While this adds overhead and cost, you might choose RoboCopy if you need advanced options such as mirroring, granular retry control, or real-time logging.
22
+
|**Copy tool**|**SMB**|**NFS**|**Description**|
23
+
|-|:-:|:-:|-|
24
+
|**[AzCopy](/azure/storage/common/storage-use-azcopy-files)**||| AzCopy is generally recommended because it uses server-to-server APIs, meaning data is copied directly between storage servers without passing through a local machine. This provides better performance. You can run AzCopy from Windows, Linux, or macOS. |
25
+
|**[Robocopy](/windows-server/administration/windows-commands/robocopy)**||| Robocopy is a Windows command-line utility that uses the SMB protocol for file copy operations. It requires mounting both file shares to a Windows virtual machine (VM). While this adds overhead and cost, you might choose Robocopy if you need advanced options such as mirroring, granular retry control, or real-time logging. |
26
+
|**[fpsync/rsync](storage-files-migration-nfs.md#using-fpsync-vs-rsync)**||| rsync is a versatile, single-threaded, open-source file copy tool. It can copy locally, to/from another host over any remote shell, or to/from a remote rsync daemon. fpsync is multithreaded and therefore offers some advantages, including the ability to run rsync jobs in parallel. Both tools require mounting the shares on a VM. |
26
27
27
28
## Copy files using AzCopy
28
29
29
30
You can use AzCopy, a command-line utility, to copy files between Azure file shares. AzCopy uses server-to-server APIs, so data is copied directly between storage servers. The instructions are different depending on whether you're using SMB or NFS file shares.
30
31
32
+
Although AzCopy doesn't require mounting the file shares to a VM, it does require a lightweight VM to run its binaries and orchestrate the copy between the two file shares via REST.
33
+
34
+
The AzCopy commands in this article use the `azcopy copy` command to copy files. The `azcopy sync` command can help synchronize deltas from the initial baseline, which is useful for setting up copy operations in another region. See [Synchronize files](/azure/storage/common/storage-use-azcopy-files#synchronize-files) for more information.
35
+
36
+
### AzCopy scale limits and performance
37
+
38
+
If you're just copying a few files, you shouldn't run into any scale limits. However, for optimal performance, each AzCopy job should transfer fewer than 10 million files. Jobs that transfer more than 50 million files can experience degraded performance because the AzCopy job tracking mechanism incurs significant overhead. To reduce overhead, consider dividing large jobs into smaller ones. There's no hard limit on individual file sizes.
39
+
40
+
The time it takes to copy can vary depending on several factors, including: the total number of files and directories to transfer, the average file size (many small files take longer to process than fewer large files), network bandwidth and latency between source and destination, storage account throttling limits, and concurrent operations on the source or destination shares.
41
+
31
42
### Properties preserved when copying files with AzCopy
32
43
33
44
When you use the `--preserve-info` and `--preserve-permissions` flags, AzCopy preserves the following file attributes and permissions:
@@ -39,7 +50,7 @@ When you use the `--preserve-info` and `--preserve-permissions` flags, AzCopy pr
39
50
40
51
### Copy files between SMB file shares
41
52
42
-
To copy files between SMB file shares, use the [azcopy copy](/azure/storage/common/storage-use-azcopy-files#copy-files-between-storage-accounts) command. You can authorize access using a SAS token or Microsoft Entra ID.
53
+
To copy files between SMB file shares, use the [azcopy copy](/azure/storage/common/storage-use-azcopy-files#copy-files-between-storage-accounts) command.
43
54
44
55
> [!TIP]
45
56
> These examples enclose path arguments with single quotes (''). Use single quotes in all command shells except for the Windows Command Shell (cmd.exe). If you're using a Windows Command Shell (cmd.exe), enclose path arguments with double quotes ("") instead of single quotes ('').
@@ -138,4 +149,3 @@ Follow these steps to copy files using Robocopy, a command-line utility included
138
149
## See also
139
150
140
151
-[Transfer data with AzCopy and file storage](/azure/storage/common/storage-use-azcopy-files)
141
-
-[Copy files from one Azure file share to another when using Azure File Sync](../file-sync/file-sync-share-to-share-migration.md)
0 commit comments