Merge pull request #234144 from sdwheeler/sdw-pr108000

Add instructions for upload/download in Cloud Shell

Author: Jill Grant

articles/cloud-shell/media/persisting-shell-storage/download.png renamed to articles/cloud-shell/media/persisting-shell-storage/download-portal.png

@@ -26,7 +26,7 @@ your behalf in the supported region that's nearest to you:
 - Storage account: `cs<uniqueGuid>`
 - fileshare: `cs-<user>-<domain>-com-<uniqueGuid>`
 
-![Screenshot of choosing the subscription for your storage account][09]
+![Screenshot of choosing the subscription for your storage account.][06]
 
 The fileshare mounts as `clouddrive` in your `$HOME` directory. This is a one-time action, and the
 fileshare mounts automatically in subsequent sessions.
@@ -47,9 +47,9 @@ and zone-redundant storage (ZRS) accounts.
 > [!NOTE]
 > Using GRS or ZRS storage accounts are recommended for additional resiliency for your backing file
 > share. Which type of redundancy depends on your goals and price preference.
-> [Learn more about replication options for Azure Storage accounts][04].
+> [Learn more about replication options for Azure Storage accounts][03].
 
-![Screenshot of configuring your storage account][08]
+![Screenshot of configuring your storage account.][05]
 
 ## Securing storage access
 
@@ -102,7 +102,7 @@ of their fileshare.
 
 Storage accounts that you create in Cloud Shell are tagged with
 `ms-resource-usage:azure-cloud-shell`. If you want to disallow users from creating storage accounts
-in Cloud Shell, create an [Azure resource policy for tags][03] that is triggered by this specific
+in Cloud Shell, create an [Azure resource policy for tags][02] that is triggered by this specific
 tag.
 
 ## How Cloud Shell storage works
@@ -128,7 +128,7 @@ Cloud Shell persists files through both of the following methods:
 In Cloud Shell, you can run a command called `clouddrive`, which enables you to manually update the
 fileshare that's mounted to Cloud Shell.
 
-![Screenshot of running the clouddrive command in bash][10]
+![Screenshot of running the clouddrive command in bash.][07]
 
 ### List `clouddrive`
 
@@ -172,7 +172,7 @@ clouddrive mount -s mySubscription -g myRG -n storageAccountName -f fileShareNam
 
 To view more details, run `clouddrive mount -h`, as shown here:
 
-![Screenshot of running the clouddrive mount command in bash][11]
+![Screenshot of running the clouddrive mount command in bash.][12]
 
 ### Unmount clouddrive
 
@@ -187,7 +187,7 @@ The unmounted fileshare continues to exist until you manually delete it. After u
 Shell no longer searches for this fileshare in subsequent sessions. To view more details, run
 `clouddrive unmount -h`, as shown here:
 
-![Screenshot of running the clouddrive unmount command in bash][12]
+![Screenshot of running the clouddrive unmount command in bash.][13]
 
 > [!WARNING]
 > Although running this command doesn't delete any resources, manually deleting a resource group,
@@ -201,7 +201,7 @@ Shell no longer searches for this fileshare in subsequent sessions. To view more
 The `Get-CloudDrive` cmdlet retrieves the Azure fileshare information currently mounted by the
 `clouddrive` in Cloud Shell.
 
-![Screenshot of running the Get-CloudDrive command in PowerShell][07]
+![Screenshot of running the Get-CloudDrive command in PowerShell.][11]
 
 ### Unmount `clouddrive`
 
@@ -212,54 +212,76 @@ Dismounting the `clouddrive` terminates the current session.
 If the Azure fileshare has been removed, you'll be prompted to create and mount a new Azure
 fileshare in the next session.
 
-![Screenshot of running the Dismount-CloudDrive command in PowerShell][06]
+![Screenshot of running the Dismount-CloudDrive command in PowerShell.][08]
 
 ## Transfer local files to Cloud Shell
 
 The `clouddrive` directory syncs with the Azure portal storage blade. Use this blade to transfer
 local files to or from your file share. Updating files from within Cloud Shell is reflected in the
 file storage GUI when you refresh the blade.
 
-### Download files
+### Download files from the Azure portal
+
+![Screenshot listing local files in the Azure portal.][09]
 
-![Screenshot listing local files in the Azure portal][13]
 1. In the Azure portal, go to the mounted file share.
-2. Select the target file.
-3. Select the **Download** button.
+1. Select the target file.
+1. Select the **Download** button.
+
+### Download files in Azure Cloud Shell
+
+1. In an Azure Cloud Shell session, select the **Upload/Download files** icon and select the
+   **Download** option.
+1. In the **Download a file** dialog, enter the path to the file you want to download.
+
+   ![Screenshot of the download dialog box in Cloud Shell.][10]
+
+   You can only download files located under your `$HOME` folder.
+1. Click the **Download** button.
 
 ### Upload files
 
-![Screenshot showing how to upload files in the Azure portal][14]
+![Screenshot showing how to upload files in the Azure portal.][14]
+
 1. Go to your mounted file share.
-2. Select the **Upload** button.
-3. Select the file or files that you want to upload.
-4. Confirm the upload.
+1. Select the **Upload** button.
+1. Select the file or files that you want to upload.
+1. Confirm the upload.
 
 You should now see the files that are accessible in your `clouddrive` directory in Cloud Shell.
 
 > [!NOTE]
 > If you need to define a function in a file and call it from the PowerShell cmdlets, then the
 > dot operator must be included. For example: `. .\MyFunctions.ps1`
 
+### Upload files in Azure Cloud Shell
+
+1. In an Azure Cloud Shell session, select the **Upload/Download files** icon and select the
+   **Upload** option.
+1. Your browser will open a file dialog. Select the file you want to upload then click the **Open**
+   button.
+
+The file is uploaded to the root of your `$HOME` folder. You can move the file after it's uploaded.
+
 ## Next steps
 
 - [Cloud Shell Quickstart][15]
-- [Learn about Microsoft Azure Files storage][05]
-- [Learn about storage tags][02]
+- [Learn about Microsoft Azure Files storage][04]
+- [Learn about storage tags][01]
 
 <!-- link references -->
-[01]: includes/cloud-shell-persisting-shell-storage-endblock.md
-[02]: ../azure-resource-manager/management/tag-resources.md
-[03]: ../governance/policy/samples/index.md
-[04]: ../storage/common/storage-redundancy.md
-[05]: ../storage/files/storage-files-introduction.md
-[06]: media/persisting-shell-storage/dismount-clouddrive.png
-[07]: media/persisting-shell-storage/get-clouddrive.png
-[08]: media/persisting-shell-storage/advanced-storage.png
-[09]: media/persisting-shell-storage/basic-storage.png
-[10]: media/persisting-shell-storage/clouddrive-h.png
-[11]: media/persisting-shell-storage/mount-h.png
-[12]: media/persisting-shell-storage/unmount-h.png
-[13]: media/persisting-shell-storage/download.png
-[14]: media/persisting-shell-storage/upload.png
+[01]: ../azure-resource-manager/management/tag-resources.md
+[02]: ../governance/policy/samples/index.md
+[03]: ../storage/common/storage-redundancy.md
+[04]: ../storage/files/storage-files-introduction.md
+[05]: media/persisting-shell-storage/advanced-storage.png
+[06]: media/persisting-shell-storage/basic-storage.png
+[07]: media/persisting-shell-storage/clouddrive-h.png
+[08]: media/persisting-shell-storage/dismount-clouddrive.png
+[09]: media/persisting-shell-storage/download-portal.png
+[10]: media/persisting-shell-storage/download-shell.png
+[11]: media/persisting-shell-storage/get-clouddrive.png
+[12]: media/persisting-shell-storage/mount-h.png
+[13]: media/persisting-shell-storage/unmount-h.png
+[14]: media/persisting-shell-storage/upload-portal.png
 [15]: quickstart.md