Changed Pv2 File Shares PowerShell Instructions

Author: VincentLiu777

articles/storage/files/storage-how-to-create-file-share.md

@@ -162,33 +162,24 @@ The final step to create the storage account is to select the **Create** button
 
 # [PowerShell](#tab/azure-powershell)
 ### Create a provisioned v2 storage account (PowerShell)
-The Az.Storage PowerShell module doesn't currently support creating provisioned v2 storage accounts. To create a provisioned v2 storage account using PowerShell, use the `New-AzResource` cmdlet. Storage account properties can be set using the `-Properties` parameter of the `New-AzResource` cmdlet. See [Microsoft.Storage resource provider REST API documentation](/rest/api/storagerp/storage-accounts/create#request-body) to learn more about the possible property names.
+To create a provisioned v2 storage account using PowerShell, use the `New-AzStorageAccount` cmdlet in the Az.Storage PowerShell module. This cmdlet has many options; only the required options are shown. To learn more about advanced options, see the [`New-AzStorageAccount` cmdlet documentation](/powershell/module/az.storage/new-azstorageaccount).
 
-To create a storage account for provisioned v2 file shares, use the following command. Remember to replace the values for the variables `$resourceGroupName`, `$storageAccountName`, `$region`, and `$storageAccountSku` with the desired values for your storage account deployment.
+To create a storage account for provisioned v2 file shares, use the following command. Remember to replace the values for the variables `$resourceGroup`, `$accountName`, `$region`, and `$storageAccountSku` with the desired values for your storage account deployment.
 
 ```PowerShell
-$resourceGroupName = "<my-resource-group>"
-$storageAccountName = "<my-storage-account-name>"
+$resourceGroup = "<my-resource-group>"
+$accountName = "<my-storage-account-name>"
 $region = "<my-region>"
-
-# Valid SKUs are StandardV2_LRS (HDD Local provisioned v2), StandardV2_ZRS (HDD 
-# Zone provisioned v2), StandardV2_GRS (HDD Geo provisioned v2), 
-# StandardV2_GZRS (HDD GeoZone provisioned v2)
+$storageAccountKind = "FileStorage"
+# Valid SKUs for provision v2 HDD file share are 'StandardV2_LRS' (HDD Local Pv2),
+# 'StandardV2_GRS' (HDD Geo Pv2), 'StandardV2_ZRS' (HDD Zone Pv2), 'StandardV2_GZRS (HDD GeoZone Pv2)'
 $storageAccountSku = "StandardV2_LRS"
 
-# Note that kind provided is FileStorage. Combining this with a valid selected 
-# SKU will result in an HDD provisioned v2 file share with the selected 
-# redundancy. It is also possible to other types of storage accounts with the 
-# New-AzResource cmdlet, however, we recommend using the New-AzStorageAccount 
-# cmdlet instead.
-$storageAccount = New-AzResource `
-        -ResourceType "Microsoft.Storage/storageAccounts" `
-        -ResourceGroupName $resourceGroupName `
-        -ResourceName $storageAccountName `
-        -Location $region `
-        -Kind "FileStorage" `
-        -Sku @{ Name = $storageAccountSku } `
-        -Confirm:$false
+New-AzStorageAccount -ResourceGroupName $resourceGroup `
+        -AccountName $accountName `
+        -SkuName $storageAccountSku `
+        -Kind $storageAccountKind `
+        -Location $region
 ```
 
 ### Create a provisioned v1 or pay-as-you-go storage account (PowerShell)
@@ -325,52 +316,29 @@ Follow these instructions to create a new Azure file share using the Azure porta
 5. Select **Review + create** and then **Create** to create the Azure file share.
 
 # [PowerShell](#tab/azure-powershell)
-You can create an Azure file share with the `New-AzResource` cmdlet. The following PowerShell commands assume you set the `$storageAccount` variable when creating a storage account in the Azure PowerShell section.
+You can create a provisioned v2 Azure file share with the `New-AzRmStorageShare` cmdlet. The following PowerShell commands assume you set the variables `$resourceGroup` and `$accountName` as defined in the "Create Storage Account" section.
 
-To create a provisioned v2 file share, use the following command. Remember to replace the values for the variables `$shareName`, `$provisionedStorageGiB`, `$provisionedIops`, and `$provisionedThroughputMibPerSec` with the desired selections for your file share deployment.
+To create a provisioned v2 file share, use the following command. Remember to replace the values for the variables `$shareName` and `$provisionedStorageGib` with the desired selections for your file share deployment.
 
 ```powershell
-$shareName = "<file-share>"
+$shareName = "<name-of-the-file-share>"
 
-# The provisioned storage size of the share in GiB. Valid range is 32 to 
-# 262,144. 
+# The provisioned storage size of the share in GiB. Valid range is 32 to 262,144.
 $provisionedStorageGib = 1024
 
-# The provisioned IOPS of the share. This is set to null here to get the 
-# recommended IOPS for the amount of provisioned storage provided, however, you 
-# can override this value if you have detail about how many IOPS your workload 
-# requires.
-$provisionedIops = $null
-
-# The provisioned throughput in MiB / sec of the share. This is set to null 
-# here to get the recommended throughput for the amount of provisioned storage 
-# provided, however, you can override this value if you have detail about how 
-# much throughput your workload requires.
-$provisionedThroughputMibPerSec = $null
-
-# Build file share properties for provisioning
-$fileShareProperties = @{ shareQuota = $provisionedStorageGib }
-
-if ($null -ne $provisionedIops) { 
-    $fileShareProperties += @{ provisionedIops = $provisionedIops } 
-}
-
-if ($null -ne $provisionedThroughputMibPerSec) {
-    $fileShareProperties += @{ 
-        provisionedBandwidthMibps = $provisionedThroughputMibPerSec 
-    }
-}
+# If you do not specify on the ProvisionedBandwidthMibps and ProvisionedIops,
+# the deployment will use the recommended provisioning.
+$provisionedIops = 3000
+$provisionedThroughputMibPerSec = 130
 
-# Build resource ID for desired file share
-$resourceId = $storageAccount.ResourceId
-$resourceId += "/fileServices/default/shares/$shareName"
+New-AzRmStorageShare -ResourceGroupName $resourceGroup `
+        -AccountName $accountName `
+        -ShareName $shareName `
+        -QuotaGiB $provisionedStorageGib;
 
-# Create resource
-New-AzResource `
-        -ResourceId $resourceId `
-        -Properties $fileShareProperties `
-        -Confirm:$false | `
-    Out-Null
+# -ProvisionedBandwidthMibps $provisionedThroughputMibPerSec -ProvisionedIops $provisionedIops
+$f = Get-AzRmStorageShare -ResourceGroupName $resourceGroup -AccountName $accountName -ShareName $shareName;
+$f | fl
 ```
 
 # [Azure CLI](#tab/azure-cli)
@@ -600,52 +568,28 @@ Follow these instructions to update the provisioning for your file share.
 5. Select **Save** to save provisioning changes. Storage, IOPS, and throughput changes are effective within a few minutes after a provisioning change.
 
 # [PowerShell](#tab/azure-powershell)
-You can modify a provisioned v2 file share with the `Set-AzResource` cmdlet. Remember to replace the values for the variables `$resourceGroupName`, `$storageAccountName`, `$fileShareName`, `$provisionedStorageGib`, `$provisionedIops`, and `$provisionedThroughputMibPerSec` with the desired values for your file share.
+You can modify a provisioned v2 file share with the `Update-AzRmStorageShare` cmdlet. Remember to replace the values for the variables `$resourceGroup`, `$accountName`, `$shareName`, `$provisionedMibps`, `$provisionedIops`, and `$provisionedStorageGib` with the desired values for your file share.
 
 ```powershell
 # The path to the file share resource to be modified.
-$resourceGroupName = "<resource-group>"
-$storageAccountName = "<storage-account>"
-$fileShareName = "<file-share>"
+$resourceGroup = "<my-resource-group>"
+$accountName = "<my-storage-account-name>"
+$shareName = "<name-of-the-file-share>"
 
-# The provisioning desired on the file share. Set these values to $null if no 
-# change is desired.
+# The provisioning desired on the file share. Delete the parameters if no change is desired.
 $provisionedStorageGib = 10240
 $provisionedIops = 10000
 $provisionedThroughputMibPerSec = 2048
 
-# Get the resource ID of the storage account
-$storageAccount = Get-AzResource `
-        -ResourceType "Microsoft.Storage/storageAccounts" `
-        -ResourceGroupName $resourceGroupName `
-        -ResourceName $storageAccountName
-
-# Build the resource ID of the file share
-$resourceId = $storageAccount.ResourceId
-$resourceId += "/fileServices/default/shares/$fileShareName"
-
-# Build the properties to be updated for the file share
-$fileShareProperties = @{}
-
-if ($null -ne $provisionedStorageGib) {
-    $fileShareProperties += @{ shareQuota = $provisionedStorageGib }
-}
-
-if ($null -ne $provisionedIops) {
-    $fileShareProperties += @{ provisionedIops = $provisionedIops }
-}
-
-if ($null -ne $provisionedThroughputMibPerSec) {
-    $fileShareProperties += @{ 
-        provisionedBandwidthMibps = $provisionedThroughputMibPerSec 
-    }
-}
-
-# Update file share with new provisioning
-Set-AzResource `
-        -ResourceId $resourceId `
-        -Properties $fileShareProperties `
-        -Confirm:$false
+# Update the file share provisioning.
+Update-AzRmStorageShare -ResourceGroupName $resourceGroup `
+        -AccountName $accountName `
+        -ShareName $shareName `
+        -ProvisionedBandwidthMibps $provisionedThroughputMibPerSec `
+        -ProvisionedIops $provisionedIops `
+        -QuotaGiB $provisionedStorageGib;
+$f = Get-AzRmStorageShare -ResourceGroupName $resourceGroup -AccountName $accountName -ShareName $shareName;
+$f | fl
 ```
 
 # [Azure CLI](#tab/azure-cli)