Skip to content

Commit ab5e3ae

Browse files
sethmanheimsethmanheim
authored
Sync release-aks-2503 with main
Sync release-aks-2503 with main
2 parents ffe06a2 + 33b9535 commit ab5e3ae

File tree

2 files changed

+128
-0
lines changed

2 files changed

+128
-0
lines changed

‎azure-local/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,8 @@ items:
213213
href: manage/azure-arc-vm-management-overview.md
214214
- name: Compare VM management capabilities
215215
href: concepts/compare-vm-management-capabilities.md
216+
- name: Supported operations for VMs
217+
href: manage/virtual-machine-operations.md
216218
- name: Review prerequisites
217219
href: manage/azure-arc-vm-management-prerequisites.md
218220
- name: Assign RBAC role

‎azure-local/manage/virtual-machine-operations.md

Lines changed: 126 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
---
2+
title: Supported operations for Azure Local virtual machines (VMs) enabled by Azure Arc
3+
description: Learn the supported virtual machine (VM) operations for Azure Local VMs enabled by Azure Arc.
4+
author: alkohli
5+
ms.author: alkohli
6+
ms.topic: how-to
7+
ms.service: azure-local
8+
ms.date: 03/18/2025
9+
---
10+
11+
# Supported operations for Azure Local virtual machines (VMs)
12+
13+
[!INCLUDE [hci-applies-to-23h2](../includes/hci-applies-to-23h2.md)]
14+
15+
This article discusses the most common operations for Azure Local virtual machines (VMs) enabled by Azure Arc. The article identifies the operations that are supported on Azure Local VMs, and the ones that you need to avoid to prevent complications.
16+
17+
## Overview
18+
19+
Azure Local can host various types of VMs including Arc-enabled servers, unmanaged VMs, and VMs enabled by Azure Arc. When comparing these options, the VMs enabled by Azure Arc provide the highest level of management capabilities in Azure portal, second only to [native Azure VMs](/azure/azure-local/concepts/compare-vm-management-capabilities).
20+
21+
While Azure Local VMs are designed to be managed through the Azure control plane and have numerous management features within the portal, on-premises local tools offer a broader range of capabilities. These tools include System Center Virtual Machine Manager (SCVMM), Failover Cluster Manager, Hyper-V Manager, and Windows Admin Center. Many IT admins use these tools to manage their on-premises VMs.
22+
23+
When IT admins manage Azure Local VMs using the same tools and scripts as those for on-premises VMs, this results in synchronization issues between the Azure Local VMs and the portal. Though the operations listed under [Supported operations for local tools](#using-local-tools) don't affect the management of Azure Local VMs, the changes aren't reflected in the Azure portal.
24+
25+
> [!NOTE]
26+
> - We recommend that you use the Azure portal or Azure CLI to manage Azure Local VMs. Use the local tools only if these operations are included in the list of [Supported operations for local tools](#using-local-tools).
27+
> - Though the operations listed under [Supported operations for local tools](#using-local-tools) don't affect the management of Azure Local VMs, the changes aren't reflected in the Azure portal.
28+
> - Only the following operations when performed using local tools update the state of the Azure Local VM in the portal: Changing the size of VM memory, vCPU count, change the power state status (Start/Stop VM) resulting from the power cycle operation.
29+
30+
## Supported operations for VMs
31+
32+
The supported operations can be performed via multiple interfaces.
33+
34+
### Using Azure portal or Azure CLI
35+
36+
> [!IMPORTANT]
37+
> Make sure to perform these VM operations only via the Azure portal or Azure CLI (and not via the local tools).
38+
39+
- Restart.
40+
- Stop.
41+
- Delete.
42+
- Add network interface.
43+
- Delete network interface.
44+
- Enable and use Windows Admin Center (for read-only).
45+
- Add data disk.
46+
- Delete data disk.
47+
- Change CPU cores.
48+
- Change memory.
49+
- Add extensions.
50+
- Delete extensions.
51+
- Enable guest management.
52+
- Connect via SSH.
53+
54+
### Using Azure CLI
55+
56+
> [!IMPORTANT]
57+
> Make sure to perform these operations only via the Azure CLI (and not via the local tools).
58+
59+
- Pause VM.
60+
- Save VM state.
61+
- Attach GPU.
62+
- Detach GPU.
63+
64+
### Using local tools
65+
66+
The following VM operations are supported only using the local tools such as Windows Admin Center, Hyper-V Manager, Failover Cluster Manager, and SCVMM. These operations are performed either on the VM itself or on the cluster/node.
67+
68+
> [!IMPORTANT]
69+
> These changes aren't reflected in the portal.
70+
71+
#### VM-level operations
72+
73+
- Rename a VM inside the guest operating system.
74+
- Rename a VM on local tools.
75+
- Change MAC address of network adapter.
76+
- Enable/disable MAC address spoofing per network adapter.
77+
- Configure Processor compatibility mode.
78+
- Configure Processor Non-Uniform Memory Access (NUMA) topology.
79+
- Configure Processor VM reserve, limit, and weight.
80+
- Enable Quality of Service (QoS) management per disk.
81+
- Add a Small Computer System Interface (SCSI) controller and move an existing data disk to another SCSI controller.
82+
- Remove a SCSI controller.
83+
- Add/remove DVD drive.
84+
- Configure dynamic memory.
85+
- Change VM boot order.
86+
- Enable/disable integration services.
87+
- Change automatic start action.
88+
- Change automatic stop action.
89+
- Enable secure boot of Generation 2 VM.
90+
91+
#### Cluster or node-level operations
92+
93+
- Connect to VM.
94+
- Quick migrate a VM to another node in the same cluster.
95+
- Live migrate a VM to another node in the same cluster.
96+
- Change default location of VM files.
97+
- Change automatic balancing of VMs in the cluster.
98+
- Change the Hyper-V MAC address range on the node.
99+
100+
#### Operations supported only via Network ATC PowerShell cmdlets
101+
102+
The following VM operations are supported only using the Network ATC PowerShell cmdlets. For more information, see [Customize cluster network settings](./manage-network-atc.md#customize-cluster-network-settings).
103+
104+
- Enable/disable single root input/output virtualization (SR-IOV) per network interface.
105+
- Configure the number of simultaneous live migrations of a cluster.
106+
- Configure the number of simultaneous storage live migrations of a cluster.
107+
- Add/remove/change order of host network for live migration of a cluster.
108+
109+
## Unsupported VM operations
110+
111+
The following VM operations aren't supported.
112+
113+
> [!IMPORTANT]
114+
> These operations can't be performed using Azure portal, Azure CLI, or local tools. Performing these operations can lead to Azure Local VMs becoming unmanageable from Azure portal.
115+
116+
- Change IP address of network adapter. To perform this operation, create a new network interface and delete the old one.
117+
- Enable/change VLAN ID per network adapter. To perform this operation, create a new network interface and delete the old one.
118+
- Live migrate a VM from one cluster to another.
119+
- Checkpoint a VM (standard or production).
120+
- Change the type of disk (static/dynamic/VHD/VHDX).
121+
- Change the size of disk (compact/expand).
122+
123+
124+
## Related content
125+
126+
- [Manage Arc VMs](manage-arc-virtual-machines.md)

0 commit comments

Comments
 (0)