Skip to content

Commit 865480a

Browse files
authored
Merge pull request #215669 from khdownie/kendownie102422-2
quickstart refresh
2 parents cb9281c + b018013 commit 865480a

File tree

5 files changed

+28
-28
lines changed

5 files changed

+28
-28
lines changed

articles/storage/files/storage-how-to-use-files-portal.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,25 +4,28 @@ description: Learn how to create and use Azure file shares with the Azure portal
44
author: khdownie
55
ms.service: storage
66
ms.topic: quickstart
7-
ms.date: 04/05/2022
7+
ms.date: 10/24/2022
88
ms.author: kendownie
99
ms.subservice: files
10-
ms.custom: mode-ui, devx-track-azurecli
10+
ms.custom: engagement-fy23, mode-ui, devx-track-azurecli
1111
ms.devlang: azurecli
1212
#Customer intent: As an IT admin new to Azure Files, I want to try out Azure Files so I can determine whether I want to subscribe to the service.
1313
---
1414

1515
# Quickstart: Create and use an Azure file share
16-
[Azure Files](storage-files-introduction.md) is Microsoft's easy-to-use cloud file system. Azure file shares can be mounted in Windows, Linux, and macOS. This guide shows you how to create an SMB Azure file share using either the Azure portal, Azure CLI, or Azure PowerShell module.
16+
[Azure Files](storage-files-introduction.md) is Microsoft's easy-to-use cloud file system. You can mount Azure file shares in Windows, Linux, and macOS operating systems. This article shows you how to create an SMB Azure file share using either the Azure portal, Azure CLI, or Azure PowerShell.
1717

1818
## Applies to
19+
20+
This Quickstart only applies to SMB Azure file shares. Standard and premium SMB file shares support locally redundant storage (LRS) and zone-redundant storage (ZRS). Standard file shares also support geo-redundant storage (GRS) and geo-zone-redundant storage (GZRS) options. For more information, see [Azure Storage redundancy](../common/storage-redundancy.md).
21+
1922
| File share type | SMB | NFS |
2023
|-|:-:|:-:|
2124
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
2225
| Standard file shares (GPv2), GRS/GZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
2326
| Premium file shares (FileStorage), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
2427

25-
## Pre-requisites
28+
## Get started
2629

2730
# [Portal](#tab/azure-portal)
2831

@@ -34,15 +37,15 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
3437

3538
[!INCLUDE [cloud-shell-try-it.md](../../../includes/cloud-shell-try-it.md)]
3639

37-
If you'd like to install and use PowerShell locally, this guide requires the Azure PowerShell module Az version 7.0.0 or later. To find out which version of the Azure PowerShell module you're running, execute `Get-InstalledModule Az`. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-Az-ps). If you're running PowerShell locally, you also need to run `Login-AzAccount` to log in to your Azure account. To use multi-factor authentication, you'll need to supply your Azure tenant ID, such as `Login-AzAccount -TenantId <TenantId>`.
40+
If you'd like to install and use PowerShell locally, you'll need the Azure PowerShell module Az version 7.0.0 or later. We recommend installing the latest available version. To find out which version of the Azure PowerShell module you're running, execute `Get-InstalledModule Az`. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-Az-ps). If you're running PowerShell locally, you also need to run `Login-AzAccount` to log in to your Azure account. To use multi-factor authentication, you'll need to supply your Azure tenant ID, such as `Login-AzAccount -TenantId <TenantId>`.
3841

3942
# [Azure CLI](#tab/azure-cli)
4043

4144
[!INCLUDE [azure-cli-prepare-your-environment.md](../../../includes/azure-cli-prepare-your-environment.md)]
4245

4346
- This article requires version 2.0.4 or later of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.
4447

45-
- By default, Azure CLI commands return JavaScript Object Notation (JSON). JSON is the standard way to send and receive messages from REST APIs. To facilitate working with JSON responses, some of the examples in this article use the *query* parameter on Azure CLI commands. This parameter uses the [JMESPath query language](http://jmespath.org/) to parse JSON. To learn more about how to use the results of Azure CLI commands by following the JMESPath query language, see the [JMESPath tutorial](http://jmespath.org/tutorial.html).
48+
- By default, Azure CLI commands return JavaScript Object Notation (JSON), which is the standard way to send and receive messages from REST APIs. To facilitate working with JSON responses, some of the examples in this article use the *query* parameter on Azure CLI commands. This parameter uses the [JMESPath query language](http://jmespath.org/) to parse JSON. To learn more about how to use the results of Azure CLI commands by following the JMESPath query language, see the [JMESPath tutorial](http://jmespath.org/tutorial.html).
4649

4750
---
4851

@@ -138,7 +141,7 @@ To create an Azure file share:
138141

139142
![A screenshot of the data storage section of the storage account; select file shares.](media/storage-how-to-use-files-portal/create-file-share-1.png)
140143

141-
1. On the menu at the top of the **File service** page, click **+ File share**. The **New file share** page drops down.
144+
1. On the menu at the top of the **File service** page, select **+ File share**. The **New file share** page drops down.
142145
1. In **Name** type *myshare*. Leave **Transaction optimized** selected for **Tier**.
143146
1. Select **Create** to create the Azure file share.
144147

@@ -184,7 +187,7 @@ To create a new directory named *myDirectory* at the root of your Azure file sha
184187

185188
1. On the **File share settings** page, select the **myshare** file share. The page for your file share opens, indicating *no files found*.
186189
1. On the menu at the top of the page, select **+ Add directory**. The **New directory** page drops down.
187-
1. Type *myDirectory* and then click **OK**.
190+
1. Type *myDirectory* and then select **OK**.
188191

189192
# [PowerShell](#tab/azure-powershell)
190193

@@ -217,7 +220,7 @@ az storage directory create \
217220
# [Portal](#tab/azure-portal)
218221

219222

220-
To demonstrate uploading a file, you first need to create or select a file to be uploaded. You may do this by whatever means you see fit. Once you've decided on the file you would like to upload:
223+
First, you need to create or select a file to upload. Do this by whatever means you see fit. When you've decided on the file you'd like to upload, follow these steps:
221224

222225
1. Select the **myDirectory** directory. The **myDirectory** panel opens.
223226
1. In the menu at the top, select **Upload**. The **Upload files** panel opens.
@@ -226,7 +229,7 @@ To demonstrate uploading a file, you first need to create or select a file to be
226229

227230
1. Select the folder icon to open a window to browse your local files.
228231
1. Select a file and then select **Open**.
229-
1. In the **Upload files** page, verify the file name and then select **Upload**.
232+
1. In the **Upload files** page, verify the file name, and then select **Upload**.
230233
1. When finished, the file should appear in the list on the **myDirectory** page.
231234

232235
# [PowerShell](#tab/azure-powershell)
@@ -250,7 +253,7 @@ Set-AzStorageFileContent `
250253

251254
If you're running PowerShell locally, substitute `~/CloudDrive/` with a path that exists on your machine.
252255

253-
After uploading the file, you can use [Get-AzStorageFile](/powershell/module/Az.Storage/Get-AzStorageFile) cmdlet to check to make sure that the file was uploaded to your Azure file share.
256+
After uploading the file, you can use the [Get-AzStorageFile](/powershell/module/Az.Storage/Get-AzStorageFile) cmdlet to check to make sure that the file was uploaded to your Azure file share.
254257

255258
```azurepowershell-interactive
256259
Get-AzStorageFile `
@@ -316,7 +319,7 @@ Get-AzStorageFileContent `
316319
-Destination "SampleDownload.txt"
317320
```
318321

319-
After downloading the file, you can use the `Get-ChildItem` to see that the file has been downloaded to your PowerShell Cloud Shell's scratch drive.
322+
After downloading the file, you can use the `Get-ChildItem` cmdlet to see that the file has been downloaded to your PowerShell Cloud Shell's scratch drive.
320323

321324
```azurepowershell-interactive
322325
Get-ChildItem | Where-Object { $_.Name -eq "SampleDownload.txt" }
@@ -348,15 +351,15 @@ az storage file download \
348351

349352
# [PowerShell](#tab/azure-powershell)
350353

351-
When you are done, you can use the [Remove-AzResourceGroup](/powershell/module/az.resources/remove-azresourcegroup) cmdlet to delete the resource group and all resources contained in the resource group.
354+
When you're done, you can use the [Remove-AzResourceGroup](/powershell/module/az.resources/remove-azresourcegroup) cmdlet to delete the resource group and all resources contained in the resource group.
352355

353356
```azurepowershell-interactive
354357
Remove-AzResourceGroup -Name myResourceGroup
355358
```
356359

357360
# [Azure CLI](#tab/azure-cli)
358361

359-
When you are done, you can use the [`az group delete`](/cli/azure/group) command to delete the resource group and all resources contained in the resource group:
362+
When you're done, you can use the [`az group delete`](/cli/azure/group) command to delete the resource group and all resources contained in the resource group:
360363

361364
```azurecli-interactive
362365
az group delete --name $resourceGroupName
99.7 KB
Loading

includes/storage-files-create-storage-account-portal.md

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,31 +2,28 @@
22
title: storage-files-create-storage-account-portal
33
description: Create a storage account for Azure Files using the Azure portal.
44
services: storage
5-
author: wmgries
5+
author: khdownie
66
ms.service: storage
77
ms.subservice: files
88
ms.topic: include
9-
ms.date: 04/01/2022
10-
ms.author: wgries
9+
ms.date: 10/24/2022
10+
ms.author: kendownie
1111
ms.custom: include file
1212
---
1313
A storage account is a shared pool of storage in which you can deploy an Azure file share or other storage resources, such as blobs or queues. 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.
1414

1515
To create a storage account using the Azure portal:
1616

17-
1. Under **Azure services**, select **+** to create a resource.
18-
1. Select **Storage account** to create a storage account.
19-
20-
:::image type="content" source="../articles/storage/files/media/storage-how-to-use-files-portal/create-storage-account-1.png" alt-text="A screenshot of the storage account option in the create a resource blade." lightbox="../articles/storage/files/media/storage-how-to-use-files-portal/create-storage-account-1.png":::
21-
17+
1. Under **Azure services**, select **Storage accounts**.
18+
1. Select **+ Create** to create a storage account.
2219
1. Under **Project details**, select the Azure subscription in which to create the storage account. If you have only one subscription, it should be the default.
23-
1. Select **Create new** to create a new resource group. For the name, enter *myResourceGroup*.
24-
1. Under **Instance details**, provide a name for the storage account such as *mystorageacct* followed by a few random numbers to make it a globally unique name. A storage account name must be all lowercase and numbers, and must be between 3 and 24 characters. Make a note of your storage account name. You will use it later.
25-
1. In **Region**, select **East US**.
20+
1. If you want to create a new resource group, select **Create new** and enter a name such as *myexamplegroup*.
21+
1. Under **Instance details**, provide a name for the storage account. You might need to add a few random numbers to make it a globally unique name. A storage account name must be all lowercase and numbers, and must be between 3 and 24 characters. Make a note of your storage account name. You'll use it later.
22+
1. In **Region**, select the region you want to create your storage account in.
2623
1. In **Performance**, keep the default value of **Standard**.
2724
1. In **Redundancy**, select **Locally redundant storage (LRS)**.
2825

29-
:::image type="content" source="../articles/storage/files/media/storage-how-to-use-files-portal/create-storage-account-2.png" alt-text="Screenshot showing how to enter the project and instance details for a storage account using the Azure portal." lightbox="../articles/storage/files/media/storage-how-to-use-files-portal/create-storage-account-2.png":::
26+
:::image type="content" source="media/storage-files-create-storage-account-portal/create-storage-account.png" alt-text="Screenshot showing how to enter the project and instance details for a storage account using the Azure portal." lightbox="media/storage-files-create-storage-account-portal/create-storage-account.png":::
3027

31-
1. Select **Review + Create** to review your settings and create the storage account.
32-
1. When you see the **Validation passed** notification, select **Create**. You should see a notification that deployment is in progress.
28+
1. Select **Review** to review your settings. Azure will run a final validation.
29+
1. When validation is complete, select **Create**. You should see a notification that deployment is in progress.

0 commit comments

Comments
 (0)