Merge pull request #3786 from MicrosoftDocs/main638902017308592975sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

azure-local/TOC.yml

@@ -568,6 +568,8 @@ items:
         href: migrate/migrate-vmware-replicate.md
       - name: Migrate, verify
         href: migrate/migrate-vmware-migrate.md
+    - name: Migrate via PowerShell
+      href: migrate/migrate-via-powershell.md
     - name: Enable guest management
       href: migrate/migrate-enable-guest-management.md
     - name: Maintain static IP addresses

azure-local/manage/manage-arc-virtual-machines.md

@@ -5,7 +5,7 @@ author: alkohli
 ms.author: alkohli
 ms.topic: how-to
 ms.service: azure-local
-ms.date: 06/09/2025
+ms.date: 07/30/2025
 ---
 
 # Manage Azure Local VMs enabled by Azure Arc
@@ -210,10 +210,26 @@ To start a VM, follow these steps in the Azure portal for your Azure Local insta
 
    :::image type="content" source="./media/manage-arc-virtual-machines/start-virtual-machine.png" alt-text="Screenshot of the button for starting a virtual machine on the overview page." lightbox="./media/manage-arc-virtual-machines/start-virtual-machine.png":::
 
-1. Select **Yes**.
+1. On the confirmation dialog, select **Yes**.
 
 1. Verify that the VM started.
 
+## Restart a VM
+
+To restart a VM, follow these steps in the Azure portal for your Azure Local instance:
+
+1. Go to the Azure Local resource, and then go to **Virtual machines**.
+
+1. In the list of virtual machines, select a VM that's stopped and that you want to restart.
+
+1. On the **Overview** page for the VM, on the command bar, select **Restart**.
+
+   :::image type="content" source="./media/manage-arc-virtual-machines/restart-virtual-machine.png" alt-text="Screenshot of the button for restarting a virtual machine on the overview page." lightbox="./media/manage-arc-virtual-machines/restart-virtual-machine.png":::
+
+1. On the confirmation dialog, select **Yes**.
+
+1. Verify that the VM restarted.
+
 ## Stop a VM
 
 To stop a VM, follow these steps in the Azure portal for your Azure Local instance:
@@ -226,31 +242,35 @@ To stop a VM, follow these steps in the Azure portal for your Azure Local instan
 
    :::image type="content" source="./media/manage-arc-virtual-machines/stop-virtual-machine.png" alt-text="Screenshot of the button for stopping a virtual machine on the overview page." lightbox="./media/manage-arc-virtual-machines/stop-virtual-machine.png":::
 
-1. Select **Yes**.
+1. On the confirmation dialog, select **Yes**.
 
 1. Verify that the VM stopped.
 
-## Restart a VM
+## Pause a VM
 
-To restart a VM, follow these steps in the Azure portal for your Azure Local instance:
+Pausing a VM is useful to save compute resources when you're not using the VM. Pausing a VM stops any CPU activity.
 
-1. Go to the Azure Local resource, and then go to **Virtual machines**.
+You can pause only running VMs. After you pause a VM, you can resume it later.
 
-1. In the list of virtual machines, select a VM that's stopped and that you want to restart.
+### [Azure portal](#tab/azureportal)
 
-1. On the **Overview** page for the VM, on the command bar, select **Restart**.
+To pause a VM, follow these steps in the Azure portal for your Azure Local instance:
 
-   :::image type="content" source="./media/manage-arc-virtual-machines/restart-virtual-machine.png" alt-text="Screenshot of the button for restarting a virtual machine on the overview page." lightbox="./media/manage-arc-virtual-machines/restart-virtual-machine.png":::
+1. Go to the Azure Local resource, and then go to **Virtual machines**.
 
-1. Select **Yes**.
+1. In the list of virtual machines, select a VM that's currently running and that you want to pause.
 
-1. Verify that the VM restarted.
+1. On the **Overview** page for the VM, on the command bar, select **Pause**.
 
-## Pause a VM
+   :::image type="content" source="./media/manage-arc-virtual-machines/pause-virtual-machine.png" alt-text="Screenshot of the button for pausing a virtual machine on the overview page." lightbox="./media/manage-arc-virtual-machines/pause-virtual-machine.png":::
 
-Pausing a VM is useful to save compute resources when you're not using the VM. Pausing a VM stops any CPU activity.
+1. On the confirmation dialog, select **Yes**.
 
-You can pause only running VMs. After you pause a VM, you can resume it later.
+1. Verify that the VM's status changed to **Paused**.
+
+### [Azure CLI](#tab/azurecli)
+
+To pause a VM, run the following commands in the Azure CLI on the computer that you're using to connect to Azure Local.
 
 1. [Connect to a machine on your system](./azure-arc-vm-management-prerequisites.md#connect-to-the-system-directly).
 
@@ -531,10 +551,32 @@ Inside _start_initial/subscriptions/<Subscription ID>/resourceGroups/<Resource g
 
 </details>
 
+---
+
 ## Save a VM
 
 Saving a VM stores its current state to the disk and stops the VM. Saving a VM frees up memory and CPU resources. You can save only running VMs.
 
+### [Azure portal](#tab/azureportal)
+
+To save a VM, follow these steps in the Azure portal for your Azure Local instance:
+
+1. Go to the Azure Local resource, and then go to **Virtual machines**.
+
+1. In the list of virtual machines, select a VM that's currently running and that you want to save.
+
+1. On the **Overview** page for the VM, on the command bar, select **Save**.
+
+   :::image type="content" source="./media/manage-arc-virtual-machines/save-virtual-machine.png" alt-text="Screenshot of the button for saving a virtual machine on the overview page." lightbox="./media/manage-arc-virtual-machines/save-virtual-machine.png":::
+
+1. On the confirmation dialog, select **Yes**.
+
+1. Verify that the VM's status changed to **Saved**.
+
+### [Azure CLI](#tab/azurecli)
+
+To save a VM, run the following commands in the Azure CLI on the computer that you're using to connect to Azure Local.
+
 1. [Connect to a machine on your system](./azure-arc-vm-management-prerequisites.md#connect-to-the-system-directly).
 
 1. Run the following Azure PowerShell cmdlet:
@@ -813,11 +855,35 @@ Inside _start_initial/subscriptions/<Subscription ID>/resourceGroups/<Resource g
 
 </details>
 
+---
+
+## Delete a VM
+
+Deleting a VM doesn't delete all the resources associated with the VM. For example, it doesn't delete the data disks and the network interfaces associated with the VM. You need to locate and delete these resources separately.
+
+To delete a VM, follow these steps in the Azure portal for your Azure Local instance:
+
+1. Go to the Azure Local resource, and then go to **Virtual machines**.
+
+1. In the list of virtual machines, select a VM that you want to remove from your system.
+
+1. On the **Overview** page for the VM, on the command bar, select **Delete**.
+
+1. On the confirmation dialog, select **Yes**.
+
+   :::image type="content" source="./media/manage-arc-virtual-machines/delete-virtual-machine-warning.png" alt-text="Screenshot of the warning for deleting a virtual machine." lightbox="./media/manage-arc-virtual-machines/delete-virtual-machine-warning.png":::
+
+1. Go to the resource group where this VM was deployed. Verify that the VM is removed from the list of resources in the resource group.
+
+1. Locate the associated resources, such as the network interfaces and data disks, and delete them. You might need to select **Show hidden types** to view the resources associated with this VM that weren't deleted.
+
+    :::image type="content" source="./media/manage-arc-virtual-machines/locate-network-interfaces-data-disks-deleted-virtual-machine.png" alt-text="Screenshot of hidden types of resources associated with a virtual machine." lightbox="./media/manage-arc-virtual-machines/locate-network-interfaces-data-disks-deleted-virtual-machine.png":::
+
 ## Change the local account password
 
 Follow these steps to change the local account passwords for an Azure Local VM deployed on your Azure Local instance. The steps are different for Windows and Linux VMs.
 
-### [Windows](#tab/windows)
+### Change the local account password for Windows VMs
 
 1. Sign in to the Azure Local VM.
 
@@ -849,7 +915,7 @@ Follow these steps to change the local account passwords for an Azure Local VM d
     }    
     ```
 
-### [Linux](#tab/linux)
+### Change the local account password for Linux VMs
 
 If Bash is in a different directory, be sure to change the `#!/bin/bash` line accordingly.
 
@@ -883,30 +949,6 @@ If Bash is in a different directory, be sure to change the `#!/bin/bash` line ac
     fi
     ```
 
----
-
-## Delete a VM
-
-Deleting a VM doesn't delete all the resources associated with the VM. For example, it doesn't delete the data disks and the network interfaces associated with the VM. You need to locate and delete these resources separately.
-
-To delete a VM, follow these steps in the Azure portal for your Azure Local instance:
-
-1. Go to the Azure Local resource, and then go to **Virtual machines**.
-
-1. In the list of virtual machines, select a VM that you want to remove from your system.
-
-1. On the **Overview** page for the VM, on the command bar, select **Delete**.
-
-1. You're prompted to confirm the deletion. Select **Yes**.
-
-   :::image type="content" source="./media/manage-arc-virtual-machines/delete-virtual-machine-warning.png" alt-text="Screenshot of the warning for deleting a virtual machine." lightbox="./media/manage-arc-virtual-machines/delete-virtual-machine-warning.png":::
-
-1. Go to the resource group where this VM was deployed. Verify that the VM is removed from the list of resources in the resource group.
-
-1. Locate the associated resources, such as the network interfaces and data disks, and delete them. You might need to select **Show hidden types** to view the resources associated with this VM that weren't deleted.
-
-    :::image type="content" source="./media/manage-arc-virtual-machines/locate-network-interfaces-data-disks-deleted-virtual-machine.png" alt-text="Screenshot of hidden types of resources associated with a virtual machine." lightbox="./media/manage-arc-virtual-machines/locate-network-interfaces-data-disks-deleted-virtual-machine.png":::
-
 ## Conduct live migration of Azure Local VMs
 
 Live migration of Azure Local VMs across Azure Local nodes is supported via on-premises tools like [Failover Cluster Manager](/windows-server/manage/windows-admin-center/use/manage-failover-clusters#adding-a-failover-cluster-to-windows-admin-center) or [Windows Admin Center](/windows-server/manage/windows-admin-center/use/manage-virtual-machines#live-migrate-a-virtual-machine-to-another-cluster-node). Live migration of VM storage is not supported.