Merge pull request #277465 from LouisBerner/v-loberner-ado-259642-resize-a-cluster-pinned-vm

Added 'Resize VM' section and links + Acrolinx.

Author: prmerger-automator[bot]

articles/databox-online/azure-stack-edge-create-vm-with-custom-size.md

@@ -7,7 +7,7 @@ author: alkohli
 ms.service: databox
 ms.subservice: edge
 ms.topic: how-to
-ms.date: 10/30/2023
+ms.date: 06/06/2024
 ms.author: alkohli
 # Customer intent: As an IT admin, I need to understand how to update a VM with custom number of cores, memory, and GPU count.
 ---
@@ -56,10 +56,10 @@ Use the following steps to get custom VM sizes for Azure Stack Edge.
 1. Run the following command to update the **Custom VM size** with the `Cores` or `MemoryMb` values for a VM you deploy to your device.
 
    Consider the following requirements and restrictions:
-   - The `Name` for these sizes cannot be modified.
+   - The `Name` for these sizes can't be modified.
    - `GpuCount` can only be a value compatible with the number of GPUs on your device, which is 1 or 2.
    - Make sure to modify the correct GPU custom size that corresponds with the GPU on your device.
-   - Once a VM is deployed with a custom size, you cannot modify that custom size again. To make a change, you will have to remove that VM first.
+   - Once a VM is deployed with a custom size, you can't modify that custom size again. To make a change, you'll have to remove that VM first.
    - Once an operation kicks off, wait at least five minutes before you deploy any other VMs or workloads; this command takes about 5 minutes to complete.
 
    The following table shows default values for available custom SKUs.
@@ -77,7 +77,7 @@ Use the following steps to get custom VM sizes for Azure Stack Edge.
       Set-HcsVMCustomSizes -CustomVMSizesJson <string> [-JsonFormat]
       ```
 
-      Here's example output where `Custom_NonGPU` is modified to have four cores and 4096 MiB of memory. 
+      Here's example output where `Custom_NonGPU` is modified to have four cores and 4,096 MiB of memory. 
 
       ```Output
       [DBE-BNVGF33.microsoftdatabox.com]: PS>Set-HcsVMCustomSizes -CustomVMSizesJson "[{'Name':'Custom_NonGPU','Cores':4,'MemoryMb':4096},{'Name':'Custom_GPU_T4_v3','Cores':8,'MemoryMb':28672,'GpuCount':2}]"
@@ -91,10 +91,12 @@ Use the following steps to get custom VM sizes for Azure Stack Edge.
    Get-AzVmSize -Location dbelocal
    ```
 
-   In Azure portal, the VM size dropdown will update in about five minutes with the new VM options you just created.
+   In Azure portal, the VM size dropdown updates in about five minutes with the new VM options you created.
 
    [![Screenshot of Azure portal dropdown menu with custom VM size.](./media/azure-stack-edge-create-vm-with-custom-size/azure-stack-edge-custom-vm-size.png)](./media/azure-stack-edge-create-vm-with-custom-size/azure-stack-edge-custom-vm-size.png#lightbox)
 
+For more information about resizing a VM, see [Deploy VMs on your Azure Stack Edge device via PowerShell](azure-stack-edge-gpu-deploy-virtual-machine-powershell.md#resize-the-vm).
+
 ## Next steps
 
  - [Create a VM](azure-stack-edge-gpu-virtual-machine-overview.md#create-a-vm).

articles/databox-online/azure-stack-edge-gpu-deploy-virtual-machine-powershell.md

@@ -7,7 +7,7 @@ author: alkohli
 ms.service: databox
 ms.subservice: edge
 ms.topic: how-to
-ms.date: 07/27/2023
+ms.date: 06/06/2024
 ms.author: alkohli
 ms.custom: devx-track-azurepowershell, linux-related-content
 #Customer intent: As an IT admin, I need to understand how to create and manage virtual machines (VMs) on my Azure Stack Edge Pro device. I want to use APIs so that I can efficiently manage my VMs.
@@ -334,7 +334,7 @@ C:\AzCopy.exe  cp "$VHDPath\$VHDFile" "$endPoint$ContainerName$StorageAccountSAS
 
 ## Create a managed disk from the VHD
 
-You'll now create a managed disk from the uploaded VHD.
+Create a managed disk from the uploaded VHD.
 
 ### [Az](#tab/az)
 
@@ -735,7 +735,7 @@ You can now use the VM image to create a VM and attach it to the virtual network
     $pass = ConvertTo-SecureString "<Password>" -AsPlainText -Force;
     $cred = New-Object System.Management.Automation.PSCredential("<Enter username>", $pass)
     ```
-    After you've created and powered up the VM, you'll use the preceding username and password to sign in to it.
+    After you create and power up the VM, use the preceding username and password to sign in to it.
 
 1. Set the parameters.
 
@@ -853,7 +853,7 @@ $pass = ConvertTo-SecureString "<Password>" -AsPlainText -Force;
 $cred = New-Object System.Management.Automation.PSCredential("<Enter username>", $pass)
 ```
 
-After you've created and powered up the VM, you'll use the following username and password to sign in to it.
+After you create and power up the VM, use the following username and password to sign in to it.
 
 ```powershell
 $VirtualMachine = New-AzureRmVMConfig -VMName <VM name> -VMSize "Standard_D1_v2"
@@ -933,7 +933,6 @@ Get-AzureRmVM -ResourceGroupName <String> -Name <String>
 
 ---
 
-
 ### Turn on the VM
 
 To turn on a virtual machine that's running on your device, run the following cmdlet:
@@ -977,6 +976,37 @@ For more information about this cmdlet, see [Stop-AzureRmVM cmdlet](/powershell/
 
 ---
 
+### Resize the VM
+
+To resize an existing virtual machine, run the following cmdlets:
+
+### [Az](#tab/az)
+
+> [!IMPORTANT]
+> Before you resize it, stop the VM without the `-StayProvisioned` flag.
+
+```powershell
+$vm = Get-AzVM [-Name] <String> [-ResourceGroupName] <String>
+
+$vm.HardwareProfile.VmSize = <new size> - Example: "Standard_D3_v2"
+
+$vm | Update-AzVM
+```
+
+### [AzureRM](#tab/azure-rm)
+
+> [!IMPORTANT]
+> Before you resize it, stop the VM without the `-StayProvisioned` flag.
+
+```powershell
+$vm = Get-AzureRmVM  [-Name] <String> [-ResourceGroupName] <String>
+
+$vm.HardwareProfile.VmSize = <new size> - Example: "Standard_D3_v2"
+
+$vm | Update-AzureRmVM
+```
+---
+
 ### Add a data disk
 
 If the workload requirements on your VM increase, you might need to add a data disk. To do so, run the following command:
@@ -998,8 +1028,6 @@ Update-AzureRmVM -ResourceGroupName "<Resource Group Name string>" -VM $VirtualM
 ```
 ---
 
-
-
 ### Delete the VM
 
 To remove a virtual machine from your device, run the following cmdlet: