Skip to content

Commit ef8c59e

Browse files
authored
Update disks-deploy-premium-v2.md
Added Azure CLI and PowerShell links
1 parent d4da030 commit ef8c59e

File tree

1 file changed

+25
-13
lines changed

1 file changed

+25
-13
lines changed

articles/virtual-machines/disks-deploy-premium-v2.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Deploy a Premium SSD v2 managed disk
33
description: Learn how to deploy a Premium SSD v2 and about its regional availability.
44
author: roygara
55
ms.author: rogarana
6-
ms.date: 01/16/2024
6+
ms.date: 01/23/2024
77
ms.topic: how-to
88
ms.service: azure-disk-storage
99
ms.custom: references_regions, devx-track-azurecli, devx-track-azurepowershell
@@ -21,12 +21,12 @@ Premium SSD v2 support a 4k physical sector size by default, but can be configur
2121

2222
## Determine region availability programmatically
2323

24-
To use a Premium SSD v2, you need to determine the regions and zones where it's supported. Not every region and zones support Premium SSD v2. For a list of regions, see [Regional availability](#regional-availability).
25-
26-
To determine regions, and zones support premium SSD v2, replace `yourSubscriptionId` then run the following command:
24+
Since not every region and zone supports Premium SSD v2, you can use the Azure CLI or PowerShell to determine region and zone supportability. For a list of supported regions, see [Regional availability](#regional-availability).
2725

2826
# [Azure CLI](#tab/azure-cli)
2927

28+
To determine the regions and zones that support Premium SSD v2, replace `yourSubscriptionId` with your subscription, and then run the [az vm list-skus](/cli/azure/vm#az-vm-list-skus) command:
29+
3030
```azurecli
3131
az login
3232
@@ -39,6 +39,8 @@ az vm list-skus --resource-type disks --query "[?name=='PremiumV2_LRS'].{Region:
3939

4040
# [PowerShell](#tab/azure-powershell)
4141

42+
To determine the regions and zones that support Premium SSD v2, replace `yourSubscriptionId` with your subscription, and then run the [Get-AzComputeResourceSku](/powershell/module/az.compute/get-azcomputeresourcesku) command:
43+
4244
```powershell
4345
Connect-AzAccount
4446
@@ -51,7 +53,7 @@ Get-AzComputeResourceSku | where {$_.ResourceType -eq 'disks' -and $_.Name -eq '
5153

5254
# [Azure portal](#tab/portal)
5355

54-
To programmatically determine the regions and zones you can deploy to, use either the Azure CLI or Azure PowerShell Module.
56+
To programmatically determine the regions and zones you can deploy to, use either the Azure CLI, Azure PowerShell Modul.
5557

5658
---
5759

@@ -61,7 +63,9 @@ Now that you know the region and zone to deploy to, follow the deployment steps
6163

6264
# [Azure CLI](#tab/azure-cli)
6365

64-
Create a Premium SSD v2 disk in an availability zone. Then create a VM in the same region and availability zone that supports Premium Storage and attach the disk to it. The following script creates a Premium SSD v2 with a 4k sector size, to deploy one with a 512 sector size, update the `$logicalSectorSize` parameter. Replace the values of all the variables with your own, then run the following script:
66+
Create a Premium SSD v2 disk in an availability zone by using the [az disk create](/cli/azure/disk#az-disk-create) command. Then create a VM in the same region and availability zone that supports Premium Storage and attach the disk to it by using the [az vm create](/cli/azure/vm#az-vm-create) command.
67+
68+
The following script creates a Premium SSD v2 with a 4k sector size, to deploy one with a 512 sector size, update the `$logicalSectorSize` parameter. Replace the values of all the variables with your own, then run the following script:
6569

6670
```azurecli-interactive
6771
## Initialize variables
@@ -99,7 +103,9 @@ az vm create -n $vmName -g $resourceGroupName \
99103

100104
# [PowerShell](#tab/azure-powershell)
101105

102-
Create a Premium SSD v2 disk in an availability zone. Then create a VM in the same region and availability zone that supports Premium Storage and attach the disk to it. The following script creates a Premium SSD v2 with a 4k sector size, to deploy one with a 512 sector size, update the `$logicalSectorSize` parameter. Replace the values of all the variables with your own, then run the following script:
106+
Create a Premium SSD v2 disk in an availability zone by using the [New-AzDiskConfig](/powershell/module/az.compute/new-azdiskconfig) to define the configuration of your disk and the [New-AzDisk](/powershell/module/az.compute/new-azdisk) command to create your disk. Next, create a VM in the same region and availability zone that supports Premium Storage by using the [az vm create](/cli/azure/vm#az-vm-create). Finally, attach the disk to it by using the [Get-AzVM](/powershell/module/az.compute/get-azvm) command to identify variables for the virtual machine, the [Get-AzDisk](/powershell/module/az.compute/get-azdisk) command to identify variables for the disk, the [Add-AzVMDataDisk](/powershell/module/az.compute/add-azvmdatadisk) command to add the disk, and the [Update-AzVM](/powershell/module/az.compute/update-azvm) command to attach the new disk to the virtual machine.
107+
108+
The following script creates a Premium SSD v2 with a 4k sector size, to deploy one with a 512 sector size, update the `$logicalSectorSize` parameter. Replace the values of all the variables with your own, then run the following script:
103109

104110
```powershell
105111
# Initialize variables
@@ -184,28 +190,34 @@ You've now deployed a VM with a premium SSD v2.
184190

185191
## Adjust disk performance
186192

187-
Unlike other managed disks, the performance of a Premium SSD v2 can be configured independently of its size. For conceptual information on this, see [Premium SSD v2 performance](disks-types.md#premium-ssd-v2-performance).
193+
Unlike other managed disks, the performance of a Premium SSD v2 can be configured independently of its size by using the Azure CLI and PowerShell. Making adjustments to disk performance by using the Azure portal is not currently supported.
194+
195+
For conceptual information on adjusting disk performance, see [Premium SSD v2 performance](disks-types.md#premium-ssd-v2-performance).
188196

189197
# [Azure CLI](#tab/azure-cli)
190198

191-
The following command changes the performance of your disk, update the values as you like, then run the command:
199+
Use the [az disk update](/cli/azure/disk#az-disk-update) command to change the performance configuration of your Premium SSD v2 disk. For example, you can use the `disk-iops-read-write` parameter to adjust the max IOPS limit, and the `disk-mbps-read-write` parameter to adjust the max throughput limit of your Premium SSD v2 disk.
200+
201+
Update the values to suit your business need, and then run the following command to adjust the performance of your disk:
192202

193203
```azurecli
194204
az disk update --subscription $subscription --resource-group $rgname --name $diskName --disk-iops-read-write=5000 --disk-mbps-read-write=200
195205
```
196206

197207
# [PowerShell](#tab/azure-powershell)
198208

199-
The following command changes the performance of your disk, update the values as you like, then run the command:
209+
Use the [New-AzDiskUpdateConfig](/powershell/module/az.compute/new-azdiskupdateconfig) command to define your new performance configuration values for your Premium SSD v2 disks, and then use the [Update-AzDisk](/powershell/module/az.compute/update-azdisk) command to apply your configuration changes to your disk. For example, you can use the `DiskIOPSReadWrite` parameter to adjust the max IOPS limit, and the `DiskMBpsReadWrite` parameter to adjust the max throughput limit of your Premium SSD v2 disk.
210+
211+
Update the values to suit your business need, and then run the following command to adjust the performance of your disk:
200212

201213
```azurepowershell
202-
$diskupdateconfig = New-AzDiskUpdateConfig -DiskMBpsReadWrite 2000
214+
$diskupdateconfig = New-AzDiskUpdateConfig -DiskIOPSReadWrite 5000 -DiskMBpsReadWrite 200
203215
Update-AzDisk -ResourceGroupName $resourceGroup -DiskName $diskName -DiskUpdate $diskupdateconfig
204216
```
205217

206218
# [Azure portal](#tab/portal)
207219

208-
Currently, adjusting disk performance is only supported with Azure CLI or the Azure PowerShell module.
220+
Currently, adjusting disk performance is only supported with the Azure CLI or Azure PowerShell module.
209221

210222
---
211223

@@ -219,6 +231,6 @@ Currently, adjusting disk performance is only supported with Azure CLI or the Az
219231

220232
## Next steps
221233

222-
Add a data disk using either the [Azure portal](linux/attach-disk-portal.md), [CLI](linux/add-disk.md), or [PowerShell](windows/attach-disk-ps.md).
234+
Add a data disk by using either the [Azure portal](linux/attach-disk-portal.md), [Azure CLI](linux/add-disk.md), or [PowerShell](windows/attach-disk-ps.md).
223235

224236
Provide feedback on [Premium SSD v2](https://aka.ms/premium-ssd-v2-survey).

0 commit comments

Comments
 (0)