Merge pull request #228035 from mattmcinnes/patch-34

Freshness Pass on resize-vm.md

Author: prmerger-automator[bot]

articles/virtual-machines/resize-vm.md

@@ -5,7 +5,7 @@ author: cynthn
 ms.service: virtual-machines
 ms.workload: infrastructure
 ms.topic: how-to
-ms.date: 11/14/2022
+ms.date: 2/21/2023
 ms.author: cynthn 
 ms.custom: devx-track-azurepowershell
 
@@ -14,9 +14,9 @@ ms.custom: devx-track-azurepowershell
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets 
 
-This article shows you how to move a VM to a different [VM size](sizes.md).
+This article shows you how to change an existing virtual machine's [VM size](sizes.md).
 
-After you create a virtual machine (VM), you can scale the VM up or down by changing the VM size. In some cases, you must deallocate the VM first. This can happen if the new size isn't available on the hardware cluster that is currently hosting the VM.
+After you create a virtual machine (VM), you can scale the VM up or down by changing the VM size. In some cases, you must deallocate the VM first. Deallocation may be necessary if the new size isn't available on the same hardware cluster that is currently hosting the VM.
 
 If your VM uses Premium Storage, make sure that you choose an **s** version of the size to get Premium Storage support. For example, choose Standard_E4**s**_v3 instead of Standard_E4_v3.
 
@@ -29,8 +29,8 @@ If your VM uses Premium Storage, make sure that you choose an **s** version of t
 1. In the left menu, select **Size**.
 1. Pick a new size from the list of available sizes and then select **Resize**.
 
-
-If the virtual machine is currently running, changing its size will cause it to restart. 
+> [!Note] 
+> If the virtual machine is currently running, changing its size will cause it to restart. 
 
 If your VM is still running and you don't see the size you want in the list, stopping the virtual machine may reveal more sizes.
 
@@ -44,15 +44,15 @@ If your VM is still running and you don't see the size you want in the list, sto
 
 To resize a VM, you need the latest [Azure CLI](/cli/azure/install-az-cli2) installed and logged in to an Azure account using [az login](/cli/azure/reference-index).
 
-1. View the list of available VM sizes on the hardware cluster where the VM is hosted with [az vm list-vm-resize-options](/cli/azure/vm). The following example lists VM sizes for the VM named `myVM` in the resource group `myResourceGroup` region:
+1. View the list of available VM sizes on the current hardware cluster using [az vm list-vm-resize-options](/cli/azure/vm). The following example lists VM sizes for the VM named `myVM` in the resource group `myResourceGroup` region:
 
     ```azurecli-interactive
     az vm list-vm-resize-options \
     --resource-group myResourceGroup \
     --name myVM --output table
     ```
 
-2. If the desired VM size is listed, resize the VM with [az vm resize](/cli/azure/vm). The following example resizes the VM named `myVM` to the `Standard_DS3_v2` size:
+2. If you find the desired VM size listed, resize the VM with [az vm resize](/cli/azure/vm). The following example resizes the VM named `myVM` to the `Standard_DS3_v2` size:
    
     ```azurecli-interactive
     az vm resize \
@@ -61,9 +61,9 @@ To resize a VM, you need the latest [Azure CLI](/cli/azure/install-az-cli2) inst
     --size Standard_DS3_v2
     ```
    
-    The VM restarts during this process. After the restart, your existing OS and data disks are kept. Anything on the temporary disk is lost.
+    The VM restarts during this process. After the restart, your VM will keep existing OS and data disks. Anything on the temporary disk will be lost.
 
-3. If the desired VM size isn't listed, you need to first deallocate the VM with [az vm deallocate](/cli/azure/vm). This process allows the VM to then be resized to any size available that the region supports and then started. The following steps deallocate, resize, and then start the VM named `myVM` in the resource group named `myResourceGroup`:
+3. If you don't see the desired VM size, deallocate the VM with [az vm deallocate](/cli/azure/vm). This process allows you to resize the VM to any size available that the region supports. The following steps deallocate, resize, and then start the VM named `myVM` in the resource group named `myResourceGroup`:
    
     ```azurecli-interactive
     # Variables will make this easier. Replace the values with your own.
@@ -99,21 +99,21 @@ $resourceGroup = "myResourceGroup"
 $vmName = "myVM"
 ```
 
-List the VM sizes that are available in the region where the VM is hosted. 
+List the VM sizes that are available in the region where you hosted the VM. 
 
 ```azurepowershell-interactive
 Get-AzVMSize -ResourceGroupName $resourceGroup -VMName $vmName 
 ```
 
-If the size you want is listed, run the following commands to resize the VM. If the desired size isn't listed, go on to step 3.
+If you see the size you want listed, run the following commands to resize the VM. If you don't see the desired size, go on to step 3.
 
 ```azurepowershell-interactive
 $vm = Get-AzVM -ResourceGroupName $resourceGroup -VMName $vmName
 $vm.HardwareProfile.VmSize = "<newVMsize>"
 Update-AzVM -VM $vm -ResourceGroupName $resourceGroup
 ```
 
-If the size you want isn't listed, run the following commands to deallocate the VM, resize it, and restart the VM. Replace **\<newVMsize>** with the size you want.
+If you don't see the size you want listed, run the following commands to deallocate the VM, resize it, and restart the VM. Replace **\<newVMsize>** with the size you want.
 
 ```azurepowershell-interactive
 Stop-AzVM -ResourceGroupName $resourceGroup -Name $vmName -Force
@@ -131,22 +131,22 @@ Start-AzVM -ResourceGroupName $resourceGroup -Name $vmName
 
 **Use PowerShell to resize a VM in an availability set**
 
-If the new size for a VM in an availability set isn't available on the hardware cluster currently hosting the VM, then all VMs in the availability set will need to be deallocated to resize the VM. You also might need to update the size of other VMs in the availability set after one VM has been resized. To resize a VM in an availability set, perform the following steps.
+If the new size for a VM in an availability set isn't available on the hardware cluster currently hosting the VM, then you will need to deallocate all VMs in the availability set to resize the VM. You also might need to update the size of other VMs in the availability set after one VM has been resized. To resize a VM in an availability set, perform the following steps.
 
 ```azurepowershell-interactive
 $resourceGroup = "myResourceGroup"
 $vmName = "myVM"
 ```
 
-List the VM sizes that are available on the hardware cluster where the VM is hosted. 
+List the VM sizes that are available on the hardware cluster where you hosted the VM. 
 
 ```azurepowershell-interactive
 Get-AzVMSize `
 -ResourceGroupName $resourceGroup `
 -VMName $vmName 
 ```
 
-If the desired size is listed, run the following commands to resize the VM. If it isn't listed, go to the next section.
+If you see the size you want listed, run the following commands to resize the VM. If you don't see it listed, go to the next section.
 
 ```azurepowershell-interactive
 $vm = Get-AzVM `
@@ -158,7 +158,7 @@ Update-AzVM `
 -ResourceGroupName $resourceGroup
 ```
 
-If the size you want isn't listed, continue with the following steps to deallocate all VMs in the availability set, resize VMs, and restart them.
+If you don't see the size you want listed, continue with the following steps to deallocate all VMs in the availability set, resize VMs, and restart them.
 
 Stop all VMs in the availability set.