Merge pull request #261369 from normesta/azcopy

A tweak to support OAuth in file service transfers

Author: prmerger-automator[bot]

articles/storage/common/storage-use-azcopy-files.md

@@ -4,7 +4,7 @@ description: Transfer data with AzCopy and file storage. AzCopy is a command-lin
 author: normesta
 ms.service: azure-storage
 ms.topic: how-to
-ms.date: 10/02/2022
+ms.date: 12/15/2023
 ms.author: normesta
 ms.subservice: storage-common-concepts
 ---
@@ -13,15 +13,22 @@ ms.subservice: storage-common-concepts
 
 AzCopy is a command-line utility that you can use to copy files to or from a storage account. This article contains example commands that work with Azure Files.
 
-Before you begin, see the [Get started with AzCopy](storage-use-azcopy-v10.md) article to download AzCopy and familiarize yourself with the tool.
+## Get started
 
-> [!TIP]
-> The examples in this article 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 ('').
+See the [Get started with AzCopy](storage-use-azcopy-v10.md) article to download AzCopy and learn about the ways that you can provide authorization credentials to the storage service.
+
+> [!NOTE]
+> The examples in this article show the use of a SAS token to authorize access. However, for commands that target files and directories, you can now provide authorization credentials by using Microsoft Entra ID and omit the SAS token from those commands. You'll still have to use a SAS token in any command that targets only the file share or the account (For example: `'azcopy make https://mystorageaccount.file.core.windows.net/myfileshare'` or `'azcopy copy 'https://mystorageaccount.file.core.windows.net'`. 
+> 
+> To learn more, see [Authorize AzCopy](storage-use-azcopy-v10.md#authorize-azcopy). 
 
 ## Create file shares
 
 You can use the [azcopy make](storage-ref-azcopy-make.md) command to create a file share. The example in this section creates a file share named `myfileshare`.
 
+> [!TIP]
+> This example encloses 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 ('').
+
 **Syntax**
 
 `azcopy make 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>'`
@@ -38,6 +45,9 @@ For detailed reference docs, see [azcopy make](storage-ref-azcopy-make.md).
 
 You can use the [azcopy copy](storage-ref-azcopy-copy.md) command to upload files and directories from your local computer.
 
+> [!TIP]
+> The examples in this section 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 ('').
+
 This section contains the following examples:
 
 > [!div class="checklist"]
@@ -63,7 +73,7 @@ This section contains the following examples:
 
 **Syntax**
 
-`azcopy copy '<local-file-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-name><SAS-token>'`
+`azcopy copy '<local-file-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-name>'`
 
 **Example**
 
@@ -174,6 +184,9 @@ For detailed reference, see the [azcopy copy](storage-ref-azcopy-copy.md) refere
 
 You can use the [azcopy copy](storage-ref-azcopy-copy.md) command to download files, directories, and file shares to your local computer.
 
+> [!TIP]
+> The examples in this section 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 ('').
+
 This section contains the following examples:
 
 > [!div class="checklist"]
@@ -323,6 +336,9 @@ AzCopy uses [server-to-server](/rest/api/storageservices/put-block-from-url) [AP
 
 You can also copy specific versions of a file by referencing the **DateTime** value of a share snapshot. To learn more about share snapshots, see [Overview of share snapshots for Azure Files](../files/storage-snapshots-files.md).
 
+> [!TIP]
+> The examples in this section 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 ('').
+
 This section contains the following examples:
 
 > [!div class="checklist"]
@@ -439,6 +455,8 @@ You can synchronize the contents of a local file system with a file share or syn
 >
 > For a complete list, see [options](storage-ref-azcopy-sync.md#options).
 
+The examples in this section 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 ('').
+
 ### Update a file share with changes to a local file system
 
 In this case, the file share is the destination, and the local file system is the source.