Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into zonalDiskMove

roygara · roygara · commit d13e02a615fe · 2020-08-26T13:41:24.000-07:00
diff --git a/articles/storage/files/storage-files-how-to-create-large-file-share.md b/articles/storage/files/storage-files-how-to-create-large-file-share.md
@@ -19,7 +19,7 @@ When you enable large file shares on your storage account, your file shares can
 
 - If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
 - If you intend to use the Azure CLI, [install the latest version](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest).
-- If you intend to use Azure PowerShell, [install the latest version](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-3.0.0).
+- If you intend to use the Azure PowerShell module, [install the latest version](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-4.6.0).
 
 ## Restrictions
 
diff --git a/articles/storage/files/storage-how-to-create-premium-fileshare.md b/articles/storage/files/storage-how-to-create-premium-fileshare.md
@@ -1,37 +1,39 @@
 ---
 title: Create a premium Azure file share
-description: In this article, learn how to create a premium Azure file share using the Azure portal, PowerShell, or the Azure CLI.
+description: Learn how to create an Azure premium file share using the Azure portal, Azure PowerShell module, or the Azure CLI.
 author: roygara
 ms.service: storage
 ms.topic: how-to
-ms.date: 05/05/2019
+ms.date: 08/26/2020
 ms.author: rogarana
 ms.subservice: files 
 ms.custom: devx-track-azurecli
-#Customer intent: As a < type of user >, I want < what? > so that < why? >.
 ---
 
-# How to create an premium Azure file share
+# How to create an Azure premium file share
+
 Premium file shares are offered on solid-state disk (SSD) storage media and are useful for IO-intensive workloads, including hosting databases and high-performance computing (HPC). Premium file shares are hosted in a special purpose storage account kind, called a FileStorage account. Premium file shares are designed for high performance and enterprise scale applications, providing consistent low latency, high IOPS, and high throughput shares.
 
-This article shows you how to create this new account type using [Azure portal](https://portal.azure.com/), Azure PowerShell, and Azure CLI.
+This article shows you how to create this new account type using the [Azure portal](https://portal.azure.com/), Azure PowerShell module, and the Azure CLI.
 
 ## Prerequisites
 
-To access Azure resources including premium Azure file shares, you'll need an Azure subscription. If you don't already have a subscription, then create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
+- If you intend to use the Azure CLI, [install the latest version](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest).
+- If you intend to use the Azure PowerShell module, [install the latest version](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-4.6.0).
+
+## Create a FileStorage storage account
+
+Every storage account must belong to an Azure resource group. A resource group is a logical container for grouping your Azure services. When you create a storage account, you have the option to either create a new resource group, or use an existing resource group. Premium file shares require a FileStorage account.
 
-## Create a premium file share using the Azure portal
+# [Portal](#tab/azure-portal)
 
 ### Sign in to Azure
 
 Sign in to the [Azure portal](https://portal.azure.com/).
 
-### Create a filestorage storage account
-
 Now you're ready to create your storage account.
 
-Every storage account must belong to an Azure resource group. A resource group is a logical container for grouping your Azure services. When you create a storage account, you have the option to either create a new resource group, or use an existing resource group. This article shows how to create a new resource group.
-
 1. In the Azure portal, select **Storage Accounts** on the left menu.
 
     ![Azure portal main page select storage account](media/storage-how-to-create-premium-fileshare/azure-portal-storage-accounts.png)
@@ -56,42 +58,9 @@ Every storage account must belong to an Azure resource group. A resource group i
 
 Once your storage account resource has been created, navigate to it.
 
-### Create a premium file share
-
-1. In the left menu for the storage account, scroll to the **File service** section, then select **Files**.
-1. Select **File share** to create a premium file share.
-1. Enter a name and a desired quota for your file share, then select **Create**.
-
-> [!NOTE]
-> Provisioned share sizes is specified by the share quota, file shares are billed on the provisioned size, refer to the [pricing page](https://azure.microsoft.com/pricing/details/storage/files/) for more details.
-
-   ![Create a premium file share](media/storage-how-to-create-premium-fileshare/create-premium-file-share.png)
-
-### Clean up resources
-
-If you would like to clean up the resources created in this article, you can simply delete the resource group. Deleting the resource group also deletes the associated storage account as well as any other resources associated with the resource group.
-
-## Create a premium file share using PowerShell
-
-### Create an account using PowerShell
-
-First, install the latest version of the [PowerShellGet](/powershell/scripting/gallery/installing-psget) module.
-
-Then, upgrade your PowerShell module, sign in to your Azure subscription, create a resource group, and then create a storage account.
-
-### Upgrade your PowerShell module
+# [PowerShell](#tab/azure-powershell)
 
-To interact with a premium file share from with PowerShell, you'll need to install an Az.Storage module version 1.4.0, or the latest Az.Storage module.
-
-Start by opening a PowerShell session with elevated permissions.
-
-Install the Az.Storage module:
-
-```powershell
-Install-Module Az.Storage -Repository PSGallery -AllowClobber -Force
-```
-
-### Sign in to your Azure Subscription
+### Sign in to Azure
 
 Use the `Connect-AzAccount` command and follow the on-screen directions to authenticate.
 
@@ -119,32 +88,11 @@ To create a FileStorage storage account from PowerShell, use the [New-AzStorageA
 $storageAcct = New-AzStorageAccount -ResourceGroupName $resourceGroup -Name "fileshowto" -SkuName "Premium_LRS" -Location "westus2" -Kind "FileStorage"
 ```
 
-### Create a premium file share
-
-Now that you have a FileStorage account, you can create a premium file share. Use the [New-AzStorageShare](/powershell/module/az.storage/New-AzStorageShare) cmdlet to create one.
-
-> [!NOTE]
-> Provisioned share sizes is specified by the share quota, file shares are billed on the provisioned size, refer to the [pricing page](https://azure.microsoft.com/pricing/details/storage/files/) for more details.
-
-```powershell
-New-AzStorageShare `
-   -Name myshare `
-   -Context $storageAcct.Context
-```
-
-### Clean up resources
-
-To remove the resource group and its associated resources, including the new storage account, use the [Remove-AzResourceGroup](/powershell/module/az.resources/remove-azresourcegroup) command: 
-
-```powershell
-Remove-AzResourceGroup -Name $resourceGroup
-```
-
-## Create a premium file share using Azure CLI
+# [Azure CLI](#tab/azure-cli)
 
 To start Azure Cloud Shell, sign in to the [Azure portal](https://portal.azure.com).
 
-If you want to log into your local installation of the CLI, first make sure you have the latest version, then run the login command:
+If you want to log into your local installation of the CLI, make sure you have the latest version, then sign in:
 
 ```azurecli
 az login
@@ -183,28 +131,77 @@ STORAGEKEY=$(az storage account keys list \
     --account-name $STORAGEACCT \
     --query "[0].value" | tr -d '"')
 ```
+---
+
+## Create a premium file share
+
+Now that you've created a FileStorage account, you can create a premium file share within that storage account.
+
+# [Portal](#tab/azure-portal)
+
+1. In the left menu for the storage account, scroll to the **File service** section, then select **Files**.
+1. Select **File share** to create a premium file share.
+1. Enter a name and a desired quota for your file share, then select **Create**.
+
+> [!NOTE]
+> Provisioned share sizes is specified by the share quota, file shares are billed on the provisioned size. For more information, see the [pricing page](https://azure.microsoft.com/pricing/details/storage/files/).
+
+   ![Create a premium file share](media/storage-how-to-create-premium-fileshare/create-premium-file-share.png)
+
+# [PowerShell](#tab/azure-powershell)
+
+To create a premium file share with the Azure PowerShell module, use the [New-AzStorageShare](/powershell/module/az.storage/New-AzStorageShare) cmdlet.
+
+> [!NOTE]
+> Provisioned share sizes is specified by the share quota, file shares are billed on the provisioned size. For more information, see the [pricing page](https://azure.microsoft.com/pricing/details/storage/files/).
+
+```powershell
+New-AzStorageShare `
+   -Name myshare `
+   -Context $storageAcct.Context
+```
 
-### Create a premium file share
+# [Azure CLI](#tab/azure-cli)
 
-Now that you have a filestorage account, you can create a premium file share. Use the [az storage share create](/cli/azure/storage/share) command to create one.
+To create a premium file share with the Azure CLI, use the [az storage share create](/cli/azure/storage/share) command.
 
 > [!NOTE]
-> Provisioned share sizes is specified by the share quota, file shares are billed on the provisioned size, refer to the [pricing page](https://azure.microsoft.com/pricing/details/storage/files/) for more details.
+> Provisioned share sizes is specified by the share quota, file shares are billed on the provisioned size. For more information, see the [pricing page](https://azure.microsoft.com/pricing/details/storage/files/).
 
 ```azurecli-interactive
 az storage share create \
     --account-name $STORAGEACCT \
     --account-key $STORAGEKEY \
     --name "myshare" 
 ```
+---
+
+## Clean up resources
+
+# [Portal](#tab/azure-portal)
+
+If you would like to clean up the resources created in this article, delete the resource group. Deleting the resource group also deletes the associated storage account as well as any other resources associated with the resource group.
+
+# [PowerShell](#tab/azure-powershell)
+
+If you would like to clean up the resources created in this article, delete the resource group. Deleting the resource group also deletes the associated storage account as well as any other resources associated with the resource group.
+
+To remove the resource group and its associated resources, including the new storage account, use the [Remove-AzResourceGroup](/powershell/module/az.resources/remove-azresourcegroup) command: 
+
+```powershell
+Remove-AzResourceGroup -Name $resourceGroup
+```
 
-### Clean up resources
+# [Azure CLI](#tab/azure-cli)
+
+If you would like to clean up the resources created in this article, delete the resource group. Deleting the resource group also deletes the associated storage account as well as any other resources associated with the resource group.
 
 To remove the resource group and its associated resources, including the new storage account, use the [az group delete](/cli/azure/group) command.
 
 ```azurecli-interactive
 az group delete --name myResourceGroup
 ```
+---
 
 ## Next steps
 
