Skip to content

Commit 47606e8

Browse files
Merge pull request #187767 from roygara/convertQS
Staging tutorial changes.
2 parents 13ac501 + b4d16f0 commit 47606e8

File tree

3 files changed

+63
-50
lines changed

3 files changed

+63
-50
lines changed

articles/storage/files/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,12 @@
77
href: storage-files-introduction.md
88
- name: Quickstarts
99
items:
10-
- name: Create / use file shares - Windows
11-
href: storage-files-quick-create-use-windows.md
1210
- name: Create file shares
1311
href: storage-how-to-use-files-portal.md
1412
- name: Tutorials
1513
items:
14+
- name: Create / use file shares - Windows
15+
href: storage-files-quick-create-use-windows.md
1616
- name: Extend Windows file servers with Azure File Sync
1717
href: ../file-sync/file-sync-extend-servers.md?toc=%2fazure%2fstorage%2ffiles%2ftoc.json
1818
- name: Concepts
171 KB
Loading
Lines changed: 61 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,76 +1,89 @@
11
---
2-
title: Create and use an Azure file shares on Windows VMs
3-
description: Create and use an Azure files shares in the Azure portal. Connect it to a Windows VM, connect to the Files share, and upload a file to the Files share.
2+
title: Tutorial - Create and use an Azure file shares on Windows VMs
3+
description: This tutorial covers how to create and use an Azure files shares in the Azure portal. Connect it to a Windows VM, connect to the file share, and upload a file to the file share.
44
author: roygara
55
ms.service: storage
6-
ms.topic: quickstart
7-
ms.date: 07/27/2021
6+
ms.topic: tutorial
7+
ms.date: 02/14/2022
88
ms.author: rogarana
99
ms.subservice: files
1010
ms.custom: mode-ui
1111
#Customer intent: As an IT admin new to Azure Files, I want to try out Azure file share so I can determine whether I want to subscribe to the service.
1212
---
1313

14-
# Quickstart: Create and manage Azure file shares with Windows virtual machines via the Azure portal
14+
# Tutorial: Create and manage Azure file shares with Windows virtual machines via the Azure portal
1515

16-
The article demonstrates the basic steps for creating and using an Azure Files share. In this quickstart, the emphasis is on quickly setting up an Azure Files share so you can experience how the service works. If you need more detailed instructions for creating and using Azure file shares in your own environment, see [Use an Azure file share with Windows](storage-how-to-use-files-windows.md).
16+
Azure Files offers fully managed file shares in the cloud that are accessible via the industry standard [Server Message Block (SMB) protocol](/windows/win32/fileio/microsoft-smb-protocol-and-cifs-protocol-overview) or [Network File System (NFS) protocol](https://en.wikipedia.org/wiki/Network_File_System). In this tutorial, you will learn a few ways you can use an Azure file share in a Windows virtual machine (VM).
1717

1818
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
1919

20+
> [!div class="checklist"]
21+
> * Create a storage account
22+
> * Create a file share
23+
> * Deploy a VM
24+
> * Connect to a VM
25+
> * Mount an Azure file share to your VM
26+
> * Create and delete a share snapshot
27+
2028
## Applies to
2129
| File share type | SMB | NFS |
2230
|-|:-:|:-:|
2331
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
2432
| Standard file shares (GPv2), GRS/GZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
2533
| Premium file shares (FileStorage), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
2634

27-
## Sign in to Azure
28-
29-
Sign in to the [Azure portal](https://portal.azure.com).
30-
31-
## Prepare your environment
35+
## Getting started
3236

33-
In this quickstart, you set up the following items:
37+
### Create a storage account
3438

35-
- An Azure storage account and an Azure file share
36-
- A Windows Server 2016 Datacenter VM
39+
Before you can work with an Azure file share, you have to create an Azure storage account.
3740

38-
### Create a storage account
41+
1. Sign in to the [Azure portal](https://portal.azure.com).
42+
1. On the Azure portal menu, select **All services**. In the list of resources, type **Storage Accounts**. As you begin typing, the list filters based on your input. Select **Storage Accounts**.
43+
1. On the **Storage Accounts** window that appears, choose **+ New**.
44+
1. On the **Basics** tab, select the subscription in which to create the storage account.
45+
1. Under the **Resource group** field, select your desired resource group, or create a new resource group.
46+
1. Next, enter a name for your storage account. The name you choose must be unique across Azure. The name also must be between 3 and 24 characters in length, and may include only numbers and lowercase letters.
47+
1. Select a region for your storage account, or use the default region.
48+
1. Select a performance tier. The default tier is *Standard*.
49+
1. Specify how the storage account will be replicated. The default redundancy option is *Geo-redundant storage (GRS)*.
50+
1. Select **Review + Create** to review your storage account settings and create the account.
51+
1. Select **Create**.
3952

40-
Before you can work with an Azure file share, you have to create an Azure storage account. A general-purpose v2 storage account provides access to all of the Azure Storage services: blobs, files, queues, and tables. The quickstart creates a general-purpose v2 storage account but, the steps to create any type of storage account are similar. A storage account can contain an unlimited number of shares. A share can store an unlimited number of files, up to the capacity limits of the storage account.
53+
The following image shows the settings on the **Basics** tab for a new storage account:
4154

42-
[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
55+
:::image type="content" source="media/storage-files-quick-create-use-windows/account-create-portal.png" alt-text="Screenshot showing how to create a storage account in the Azure portal." lightbox="media/storage-files-quick-create-use-windows/account-create-portal.png":::
4356

4457
### Create an Azure file share
4558

46-
Next, you create a file share.
59+
Next, create a file share.
4760

4861
1. When the Azure storage account deployment is complete, select **Go to resource**.
4962
1. Select **File shares** from the storage account pane.
5063

51-
![Select File shares.](./media/storage-files-quick-create-use-windows/click-files.png)
64+
![Screenshot, File shares selected.](./media/storage-files-quick-create-use-windows/click-files.png)
5265

5366
1. Select **+ File Share**.
5467

55-
![Select + file share to create a new file share.](./media/storage-files-quick-create-use-windows/create-file-share.png)
68+
![Screenshot, + file share selected to create a new file share.](./media/storage-files-quick-create-use-windows/create-file-share.png)
5669

57-
1. Name the new file share *qsfileshare*, enter "1" for the **Quota**, leave **Transaction optimized** selected, and select **Create**. The quota can be a maximum of 5 TiB (100 TiB, with large file shares enabled), but you only need 1 GiB for this quickstart.
70+
1. Name the new file share *qsfileshare*, enter "1" for the **Quota**, leave **Transaction optimized** selected, and select **Create**. The quota can be a maximum of 5 TiB (100 TiB, with large file shares enabled), but you only need 1 GiB for this.
5871
1. Create a new txt file called *qsTestFile* on your local machine.
5972
1. Select the new file share, then on the file share location, select **Upload**.
6073

61-
![Upload a file.](./media/storage-files-quick-create-use-windows/create-file-share-portal5.png)
74+
![Screenshot of file upload.](./media/storage-files-quick-create-use-windows/create-file-share-portal5.png)
6275

6376
1. Browse to the location where you created your .txt file > select *qsTestFile.txt* > select **Upload**.
6477

65-
So far, you've created an Azure storage account and a file share with one file in it in Azure. Next you'll create the Azure VM with Windows Server 2016 Datacenter to represent the on-premises server in this quickstart.
66-
6778
### Deploy a VM
6879

69-
1. Next, expand the menu on the left side of the portal and choose **Create a resource** in the upper left-hand corner of the Azure portal.
80+
So far, you've created an Azure storage account and a file share with one file in it. Next, create an Azure VM with Windows Server 2016 Datacenter to represent the on-premises server.
81+
82+
1. Expand the menu on the left side of the portal and select **Create a resource** in the upper left-hand corner of the Azure portal.
7083
1. Under **Popular services** select **Virtual machine**.
71-
1. In the **Basics** tab, under **Project details**, select the resource group you created for this quickstart.
84+
1. In the **Basics** tab, under **Project details**, select the resource group you created earlier.
7285

73-
![Enter basic information about your VM in the portal blade.](./media/storage-files-quick-create-use-windows/vm-resource-group-and-subscription.png)
86+
![Screenshot of Basic tab, basic VM information filled out.](./media/storage-files-quick-create-use-windows/vm-resource-group-and-subscription.png)
7487

7588
1. Under **Instance details**, name the VM *qsVM*.
7689
1. For **Image** select **Windows Server 2016 Datacenter - Gen2**.
@@ -82,23 +95,23 @@ So far, you've created an Azure storage account and a file share with one file i
8295

8396
1. Once your VM deployment is complete, select **Go to resource**.
8497

85-
At this point, you've created a new virtual machine and attached a data disk. Now you need to connect to the VM.
86-
8798
### Connect to your VM
8899

100+
Now that you've created the VM, connect to it so you can mount your file share.
101+
89102
1. Select **Connect** on the virtual machine properties page.
90103

91-
![Connect to an Azure VM from the portal](./media/storage-files-quick-create-use-windows/connect-vm.png)
104+
![Screenshot of VM tab, +Connect highlighted.](./media/storage-files-quick-create-use-windows/connect-vm.png)
92105

93106
1. In the **Connect to virtual machine** page, keep the default options to connect by **IP address** over **port number** *3389* and select **Download RDP file**.
94107
1. Open the downloaded RDP file and select **Connect** when prompted.
95108
1. In the **Windows Security** window, select **More choices** and then **Use a different account**. Type the username as *localhost\username*, where <username> is the VM admin username you created for the virtual machine. Enter the password you created for the virtual machine, and then select **OK**.
96109

97-
![More choices](./media/storage-files-quick-create-use-windows/local-host2.png)
110+
![Screenshot of VM login prompt, More choices highlighted.](./media/storage-files-quick-create-use-windows/local-host2.png)
98111

99-
1. You may receive a certificate warning during the sign-in process. select **Yes** or **Continue** to create the connection.
112+
1. You may receive a certificate warning during the sign-in process. Select **Yes** or **Continue** to create the connection.
100113

101-
## Map the Azure file share to a Windows drive
114+
### Map the Azure file share to a Windows drive
102115

103116
1. In the Azure portal, navigate to the *qsfileshare* fileshare and select **Connect**.
104117
1. Select a drive letter then copy the contents of the second box and paste it in **Notepad**.
@@ -109,29 +122,29 @@ At this point, you've created a new virtual machine and attached a data disk. No
109122

110123
## Create a share snapshot
111124

112-
Now that you've mapped the drive, you can create a snapshot.
125+
Now that you've mapped the drive, create a snapshot.
113126

114127
1. In the portal, navigate to your file share, select **Snapshots**, then select **+ Add snapshot**.
115128

116-
![Select snapshots under the operations section, then select add snapshot.](./media/storage-files-quick-create-use-windows/create-snapshot.png)
129+
![Screenshot of storage account snapshots tab.](./media/storage-files-quick-create-use-windows/create-snapshot.png)
117130

118-
1. In the VM, open the *qstestfile.txt* and type "this file has been modified" > Save and close the file.
131+
1. In the VM, open the *qstestfile.txt* and type "this file has been modified". Save and close the file.
119132
1. Create another snapshot.
120133

121134
## Browse a share snapshot
122135

123136
1. On your file share, select **Snapshots**.
124-
1. On the **Snapshots** blade, select the first snapshot in the list.
137+
1. On the **Snapshots** tab, select the first snapshot in the list.
125138

126-
![Selected snapshot in the list of time stamps](./media/storage-files-quick-create-use-windows/snapshot-list.png)
139+
![Snapshots tab, first snapshot highlighted.](./media/storage-files-quick-create-use-windows/snapshot-list.png)
127140

128141
1. Open that snapshot, and select *qsTestFile.txt*.
129142

130143
## Restore from a snapshot
131144

132-
1. From the file share snapshot blade, right-click the *qsTestFile*, and select the **Restore** button.
145+
1. From the file share snapshot tab, right-click the *qsTestFile*, and select the **Restore** button.
133146

134-
:::image type="content" source="media/storage-files-quick-create-use-windows/restore-share-snapshot.png" alt-text="Screenshot of the snapshot blade, qstestfile is selected, restore is highlighted.":::
147+
:::image type="content" source="media/storage-files-quick-create-use-windows/restore-share-snapshot.png" alt-text="Screenshot of the snapshot tab, qstestfile is selected, restore is highlighted.":::
135148

136149
1. Select **Overwrite original file**.
137150

@@ -142,33 +155,33 @@ Now that you've mapped the drive, you can create a snapshot.
142155
## Delete a share snapshot
143156

144157
1. On your file share, select **Snapshots**.
145-
1. On the **Snapshots** blade, select the last snapshot in the list and select **Delete**.
158+
1. On the **Snapshots** tab, select the last snapshot in the list and select **Delete**.
146159

147-
![Screenshot of the snapshots blade, last snapshot selected, delete button highlighted.](./media/storage-files-quick-create-use-windows/portal-snapshots-delete.png)
160+
![Screenshot of the snapshots tab, last snapshot selected, delete button highlighted.](./media/storage-files-quick-create-use-windows/portal-snapshots-delete.png)
148161

149162
## Use a share snapshot in Windows
150163

151164
Just like with on-premises VSS snapshots, you can view the snapshots from your mounted Azure file share by using the Previous Versions tab.
152165

153166
1. In File Explorer, locate the mounted share.
154167

155-
![Mounted share in File Explorer](./media/storage-files-quick-create-use-windows/snapshot-windows-mount.png)
168+
![Screenshot of a mounted share in File Explorer.](./media/storage-files-quick-create-use-windows/snapshot-windows-mount.png)
156169

157170
1. Select *qsTestFile.txt* and > right-click and select **Properties** from the menu.
158171

159-
![Right-click menu for a selected directory](./media/storage-files-quick-create-use-windows/snapshot-windows-previous-versions.png)
172+
![Screenshot of the right-click menu for a selected directory.](./media/storage-files-quick-create-use-windows/snapshot-windows-previous-versions.png)
160173

161174
1. Select **Previous Versions** to see the list of share snapshots for this directory.
162175

163176
1. Select **Open** to open the snapshot.
164177

165-
![Previous Versions tab](./media/storage-files-quick-create-use-windows/snapshot-windows-list.png)
178+
![Screenshot of previous Versions tab.](./media/storage-files-quick-create-use-windows/snapshot-windows-list.png)
166179

167180
## Restore from a previous version
168181

169-
1. Select **Restore**. This action copies the contents of the entire directory recursively to the original location at the time the share snapshot was created.
182+
1. Select **Restore**. This copies the contents of the entire directory recursively to the original location at the time the share snapshot was created.
170183

171-
![Restore button in warning message](./media/storage-files-quick-create-use-windows/snapshot-windows-restore.png)
184+
![Screenshot of previous versions, restore button in warning message is highlighted.](./media/storage-files-quick-create-use-windows/snapshot-windows-restore.png)
172185

173186
> [!NOTE]
174187
> If your file has not changed, you will not see a previous version for that file because that file is the same version as the snapshot. This is consistent with how this works on a Windows file server.
@@ -180,4 +193,4 @@ Just like with on-premises VSS snapshots, you can view the snapshots from your m
180193
## Next steps
181194

182195
> [!div class="nextstepaction"]
183-
> [Use an Azure file share with Windows](storage-how-to-use-files-windows.md)
196+
> [Use an Azure file share with Windows](storage-how-to-use-files-windows.md)

0 commit comments

Comments
 (0)