Minimizing the number of times that this tip appears in the docs

Author: normesta

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

@@ -27,6 +27,9 @@ See the [Get started with AzCopy](storage-use-azcopy-v10.md) article to download
 
 ## Create a container
 
+> [!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 ('').
+
 You can use the [azcopy make](storage-ref-azcopy-make.md) command to create a container. The examples in this section create a container named `mycontainer`.
 
 |    |     |
@@ -35,9 +38,6 @@ You can use the [azcopy make](storage-ref-azcopy-make.md) command to create a co
 | **Example** | `azcopy make 'https://mystorageaccount.blob.core.windows.net/mycontainer'` |
 | **Example** (hierarchical namespace) | `azcopy make 'https://mystorageaccount.dfs.core.windows.net/mycontainer'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 For detailed reference docs, see [azcopy make](storage-ref-azcopy-make.md).
 
 ## Upload files
@@ -52,11 +52,11 @@ This section contains the following examples:
 > * Upload the contents of a directory 
 > * Upload specific files
 
-> [!NOTE]
-> AzCopy doesn't automatically calculate and store the file's md5 hash code. If you want AzCopy to do that, then append the `--put-md5` flag to each copy command. That way, when the blob is downloaded, AzCopy calculates an MD5 hash for downloaded data and verifies that the MD5 hash stored in the blob's `Content-md5` property matches the calculated hash.
-
 For detailed reference docs, see [azcopy copy](storage-ref-azcopy-copy.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 ('').
+
 ### Upload a file
 
 |    |     |
@@ -65,9 +65,6 @@ For detailed reference docs, see [azcopy copy](storage-ref-azcopy-copy.md).
 | **Example** | `azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt'` |
 | **Example** (hierarchical namespace) | `azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 You can also upload a file by using a wildcard symbol (*) anywhere in the file path or file name. For example: `'C:\myDirectory\*.txt'`, or `C:\my*\*.txt`.
 
 > [!NOTE]
@@ -83,19 +80,13 @@ This example copies a directory (and all of the files in that directory) to a bl
 | **Example** | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive` |
 | **Example** (hierarchical namespace) | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 To copy to a directory within the container, just specify the name of that directory in your command string.
 
 |    |     |
 |--------|-----------|
 | **Example** | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' --recursive` |
 | **Example** (hierarchical namespace) | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 If you specify the name of a directory that does not exist in the container, AzCopy creates a new directory by that name.
 
 ### Upload the contents of a directory
@@ -108,9 +99,6 @@ You can upload the contents of a directory without copying the containing direct
 | **Example** | `azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory'` |
 | **Example** (hierarchical namespace) | `azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 > [!NOTE]
 > Append the `--recursive` flag to upload files in all sub-directories.
 
@@ -128,14 +116,10 @@ Use the [azcopy copy](storage-ref-azcopy-copy.md) command with the `--include-pa
 | **Example** | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive` |
 | **Example** (hierarchical namespace) | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 In this example, AzCopy transfers the `C:\myDirectory\photos` directory and the `C:\myDirectory\documents\myFile.txt` file. You need to include the `--recursive` option to transfer all files in the `C:\myDirectory\photos` directory.
 
 You can also exclude files by using the `--exclude-path` option. To learn more, see [azcopy copy](storage-ref-azcopy-copy.md) reference docs.
 
-
 #### Use wildcard characters
 
 Use the [azcopy copy](storage-ref-azcopy-copy.md) command with the `--include-pattern` option. Specify partial names that include the wildcard characters. Separate names by using a semicolin (`;`). 
@@ -146,9 +130,6 @@ Use the [azcopy copy](storage-ref-azcopy-copy.md) command with the `--include-pa
 | **Example** | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'` |
 | **Example** (hierarchical namespace) | `azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 You can also exclude files by using the `--exclude-pattern` option. To learn more, see [azcopy copy](storage-ref-azcopy-copy.md) reference docs.
 
 The `--include-pattern` and `--exclude-pattern` options apply only to filenames and not to the path.  If you want to copy all of the text files that exist in a directory tree, use the `–recursive` option to get the entire directory tree, and then use the `–include-pattern` and specify `*.txt` to get all of the text files.
@@ -170,6 +151,9 @@ This section contains the following examples:
 
 For detailed reference docs, see [azcopy copy](storage-ref-azcopy-copy.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 ('').
+
 ### Download a file
 
 |    |     |
@@ -178,9 +162,6 @@ For detailed reference docs, see [azcopy copy](storage-ref-azcopy-copy.md).
 | **Example** | `azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'` |
 | **Example** (hierarchical namespace) | `azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 ### Download a directory
 
 |    |     |
@@ -189,9 +170,6 @@ For detailed reference docs, see [azcopy copy](storage-ref-azcopy-copy.md).
 | **Example** | `azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory'  --recursive` |
 | **Example** (hierarchical namespace) | `azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory 'C:\myDirectory'  --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 This example results in a directory named `C:\myDirectory\myBlobDirectory` that contains all of the downloaded files.
 
 ### Download the contents of a directory
@@ -206,9 +184,6 @@ You can download the contents of a directory without copying the containing dire
 | **Syntax** | `azcopy copy 'https://<storage-account-name>.blob.core.windows.net/<container-name>/*' '<local-directory-path>/'` |
 | **Example** | `azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory/*' 'C:\myDirectory'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 > [!NOTE]
 > Append the `--recursive` flag to download files in all sub-directories.
 
@@ -226,9 +201,6 @@ Use the [azcopy copy](storage-ref-azcopy-copy.md) command with the `--include-pa
 | **Example** | `azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt' --recursive` |
 | **Example** (hierarchical namespace) | `azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt'--recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 In this example, AzCopy transfers the `https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos` directory and the `https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/documents/myFile.txt` file. You need to include the `--recursive` option to transfer all files in the `https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos` directory.
 
 You can also exclude files by using the `--exclude-path` option. To learn more, see [azcopy copy](storage-ref-azcopy-copy.md) reference docs.
@@ -243,9 +215,6 @@ Use the [azcopy copy](storage-ref-azcopy-copy.md) command with the `--include-pa
 | **Example** | `azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*'` |
 | **Example** (hierarchical namespace) | `azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 You can also exclude files by using the `--exclude-pattern` option. To learn more, see [azcopy copy](storage-ref-azcopy-copy.md) reference docs.
 
 The `--include-pattern` and `--exclude-pattern` options apply only to filenames and not to the path.  If you want to copy all of the text files that exist in a directory tree, use the `–recursive` option to get the entire directory tree, and then use the `–include-pattern` and specify `*.txt` to get all of the text files.
@@ -273,44 +242,36 @@ This section contains the following examples:
 
 For detailed reference docs, see [azcopy copy](storage-ref-azcopy-copy.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 ('').
+
 ### Copy a blob to another storage account
 
 |    |     |
 |--------|-----------|
 | **Syntax** | `azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path>?<SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path>'` |
 | **Example** | `azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt'` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 ### Copy a directory to another storage account
 
 |    |     |
 |--------|-----------|
 | **Syntax** | `azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<directory-path>?<SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>' --recursive` |
 | **Example** | `azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 ### Copy a container to another storage account
 
 |    |     |
 |--------|-----------|
 | **Syntax** | `azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>?<SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>' --recursive` |
 | **Example** | `azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 ### Copy all containers, directories, and blobs to another storage account
 
 |    |     |
 |--------|-----------|
 | **Syntax** | `azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/?<SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/' --recursive'` |
 | **Example** | `azcopy copy 'https://mysourceaccount.blob.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.blob.core.windows.net' --recursive` |
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
 
 ## Synchronize files
 
@@ -328,6 +289,9 @@ If you set the `--delete-destination` flag to `true` AzCopy deletes files withou
 
 For detailed reference docs, see [azcopy sync](storage-ref-azcopy-sync.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 ('').
+
 ### Update a container with changes to a local file system
 
 In this case, the container is the destination, and the local file system is the source.
@@ -337,9 +301,6 @@ In this case, the container is the destination, and the local file system is the
 | **Syntax** | `azcopy sync '<local-directory-path>' 'https://<storage-account-name>.blob.core.windows.net/<container-name>' --recursive` |
 | **Example** | `azcopy sync 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 ### Update a local file system with changes to a container
 
 In this case, the local file system is the destination, and the container is the source.
@@ -349,8 +310,6 @@ In this case, the local file system is the destination, and the container is the
 | **Syntax** | `azcopy sync 'https://<storage-account-name>.blob.core.windows.net/<container-name>' 'C:\myDirectory' --recursive` |
 | **Example** | `azcopy sync 'https://mystorageaccount.blob.core.windows.net/mycontainer' 'C:\myDirectory' --recursive` |
 |
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
 
 ### Update a container with changes in another container
 
@@ -361,8 +320,6 @@ The first container that appears in this command is the source. The second one i
 | **Syntax** | `azcopy sync 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>' --recursive` |
 | **Example** | `azcopy sync 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive` |
 
-In a Windows Command Shell (cmd.exe), enclose paths in double quotes ("") instead of single quotes ('').
-
 ### Update a directory with changes to a directory in another file share
 
 The first directory that appears in this command is the source. The second one is the destination.
@@ -372,9 +329,6 @@ The first directory that appears in this command is the source. The second one i
 | **Syntax** | `azcopy sync 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<directory-name>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<directory-name>' --recursive` |
 | **Example** | `azcopy copy 'https://mysourceaccount.blob.core.windows.net/<container-name>/myDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myDirectory' --recursive` |
 
-> [!TIP]
-> If you're using a Windows Command Shell (cmd.exe), enclose path arguments in double quotes ("") instead of single quotes ('').
-
 ## Next steps
 
 Find more examples in any of these articles: