You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: azure-local/manage/virtual-machine-manage-extension.md
+32-36Lines changed: 32 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,84 +29,80 @@ For a full list of supported VM extensions, see:
29
29
30
30
## Verify that guest management is enabled
31
31
32
-
To manage VMs on Azure Local, you must enable guest management on the VMs. When you enable guest management, an agent is installed on the VM.
32
+
To manage VMs on Azure Local, you must enable guest management on the VMs. When you enable guest management on a VM, an agent is installed on the VM.
33
33
34
34
You must verify that guest management is enabled on your VMs before you install VM extensions.
35
35
36
36
> [!NOTE]
37
-
> Domain Join extensions are supported only for Windows VMs. These extensions can only be enabled and installed during VM creation via the Azure portal. For more information on how to enable Domain Join extension when creating Azure Arc VMs, see [Create Azure Arc VMs in Azure Local](./create-arc-virtual-machines.md).
37
+
> Extensions for domain join are supported only for Windows VMs. You can enable and install these extensions only during VM creation, via the Azure portal. For more information, see [Create Azure Arc virtual machines on Azure Local](./create-arc-virtual-machines.md).
38
38
39
-
Follow these steps to verify that guest management is enabled using the Azure portal:
39
+
To verify that guest management is enabled:
40
40
41
-
1. In the Azure portal of your Azure Local resource, go to **Resources** > **Virtual machines**.
41
+
1. In the Azure portal for your Azure Local resource, go to **Resources** > **Virtual machines**.
42
42
43
-
1.From the list of the VMs displayed in the right-pane, select the VM where you'll install the extension.
43
+
1.In the list of VMs, select the VM where you want to install the extension.
44
44
45
-
1.In the **Overview**blade, under **Properties > Configuration**, verify that the **Guest management** shows as**Enabled**.
45
+
1.On the **Overview**pane, under **Properties** > **Configuration**, verify that **Guest management** shows **Enabled**.
46
46
47
-
:::image type="content" source="./media/virtual-machine-manage-extension/verify-guest-management-enablement-1.png" alt-text="Screenshot showing guest management as enabled in the selected Arc-enabled VM." lightbox="./media/virtual-machine-manage-extension/verify-guest-management-enablement-1.png":::
47
+
:::image type="content" source="./media/virtual-machine-manage-extension/verify-guest-management-enablement-1.png" alt-text="Screenshot that shows guest management enabled for a selected Azure Arc virtual machine." lightbox="./media/virtual-machine-manage-extension/verify-guest-management-enablement-1.png":::
48
48
49
-
## Add VM extension
49
+
## Add a VM extension
50
50
51
-
After the guest management enablement is verified, you can now add the VM extension.
51
+
After you verify that guest management is enabled, follow these steps to add a VM extension:
52
52
53
-
Follow these steps in Azure portal to add a VM extension.
53
+
1. In the Azure portal for your Azure Local resource, go to **Resources** > **Virtual machines**.
54
54
55
-
1.In the Azure portal of your Azure Local resource, go to **Resources > Virtual machines**.
55
+
1.Select your VM, and then go to **Settings** > **Extensions**.
56
56
57
-
1.Select your VM and go to **Settings > Extensions**.
57
+
1.On the command bar, select **+ Add**.
58
58
59
-
1. From the top of the command bar in the right-pane, select **+ Add**.
59
+
:::image type="content" source="./media/virtual-machine-manage-extension/add-azure-monitor-extension-1.png" alt-text="Screenshot that shows the command to add an extension on the chosen Azure Arc virtual machine." lightbox="./media/virtual-machine-manage-extension/add-azure-monitor-extension-1.png":::
60
60
61
-
:::image type="content" source="./media/virtual-machine-manage-extension/add-azure-monitor-extension-1.png" alt-text="Screenshot showing + Add selected to add an extension in the chosen Azure Arc VM." lightbox="./media/virtual-machine-manage-extension/add-azure-monitor-extension-1.png":::
61
+
1. On the **Install extension** pane, choose from the available extensions. In this example, we'll deploy **Azure Monitor Agent for Windows (Recommended)**.
62
62
63
-
1. In the **Install extension**, choose from the available extensions. In this example, we'll deploy the **Azure Monitor Agent for Windows (Recommended)**.
64
-
65
-
:::image type="content" source="./media/virtual-machine-manage-extension/add-azure-monitor-extension-2.png" alt-text="Screenshot showing the Azure Monitor Extension selected in the chosen Azure Arc VM." lightbox="./media/virtual-machine-manage-extension/add-azure-monitor-extension-2.png":::
63
+
:::image type="content" source="./media/virtual-machine-manage-extension/add-azure-monitor-extension-2.png" alt-text="Screenshot that shows the Azure Monitor extension selected for the chosen Azure Arc virtual machine." lightbox="./media/virtual-machine-manage-extension/add-azure-monitor-extension-2.png":::
66
64
67
65
1. Provide the parameters to configure the selected VM extension.
68
66
69
-
In this example, you specify if you want to use proxy for your VM and the corresponding proxy settings such as proxy server URL and port number.
67
+
In this example, you specify if you want to use a proxy for your VM. You also specify corresponding proxy settings, such as proxy server URL and port number.
70
68
71
-
:::image type="content" source="./media/virtual-machine-manage-extension/add-azure-monitor-extension-3.png" alt-text="Screenshot showing configuration of Azure Monitor Extension installation in the chosen Azure Arc VM." lightbox="./media/virtual-machine-manage-extension/add-azure-monitor-extension-3.png":::
69
+
:::image type="content" source="./media/virtual-machine-manage-extension/add-azure-monitor-extension-3.png" alt-text="Screenshot that shows the configuration of Azure Monitor Extension installation for the chosen Azure Arc VM." lightbox="./media/virtual-machine-manage-extension/add-azure-monitor-extension-3.png":::
72
70
73
71
1. Select **Review + Create**.
74
72
75
73
The extension might take a few minutes to install. After the extension is installed, the list refreshes to display the newly installed extension.
76
74
77
75
## List installed extensions
78
76
79
-
You can get a list of all the VM extensions installed on your Azure Local.
77
+
To list all the VM extensions installed on your Azure Local instance:
80
78
81
-
Follow these steps in Azure portal to list the installed VM extensions.
79
+
1. In the Azure portal for your Azure Local resource, go to **Resources** > **Virtual machines**.
82
80
83
-
1.In the Azure portal of your Azure Local resource, go to **Resources > Virtual machines**.
81
+
1.Select your VM, and then select **Extensions**.
84
82
85
-
1. Select your VM and select **Extensions**.
83
+
The **Extensions** pane shows the list of extensions on your VM.
86
84
87
-
1. In the right pane, you can view the list of extensions on your VM.
85
+
:::image type="content" source="./media/virtual-machine-manage-extension/list-virtual-machine-extension-1.png" alt-text="Screenshot that shows the list of installed extensions for the chosen Azure Arc virtual machine." lightbox="./media/virtual-machine-manage-extension/list-virtual-machine-extension-1.png":::
88
86
89
-
:::image type="content" source="./media/virtual-machine-manage-extension/list-virtual-machine-extension-1.png" alt-text="Screenshot showing the list of installed extensions for the chosen Arc-enabled VM." lightbox="./media/virtual-machine-manage-extension/list-virtual-machine-extension-1.png":::
87
+
## Delete a VM extension
90
88
91
-
## Delete VM extension
89
+
You might want to delete a VM extension if the installation fails or if you no longer need the extension.
92
90
93
-
You might want to delete a VM extension if the installation fails for some reason or if the extension is no longer needed.
91
+
1. In the Azure portal for your Azure Local resource, go to **Resources** > **Virtual machines**.
94
92
95
-
1.In the Azure portal of your Azure Local resource, go to **Resources > Virtual machines**.
93
+
1.Select your VM, and then select **Extensions**.
96
94
97
-
1.Select your VM and select **Extensions**.
95
+
1.In the list of extensions on your VM, select the extension that you want to delete.
98
96
99
-
1.From the list of extensions on your VM, choose the extension you wish to remove. From the top command bar, select **Uninstall** to remove the extension.
97
+
1.On the command bar, select **Uninstall** to delete the extension.
100
98
101
-
In this example, **AzureMonitorWindowsAgent** is selected.
99
+
In this example, **AzureMonitorWindowsAgent** is selected for deletion.
102
100
103
101
:::image type="content" source="./media/virtual-machine-manage-extension/uninstall-azure-monitor-extension-1.png" alt-text="Screenshot showing Uninstall selected for the chosen Arc-enabled VM." lightbox="./media/virtual-machine-manage-extension/uninstall-azure-monitor-extension-1.png":::
104
102
105
-
The extension should take a couple minutes for removal.
103
+
Removal of the extension from the list should take a couple of minutes.
106
104
107
105
## Related content
108
106
109
-
Learn how to:
110
-
111
-
-[Enable guest management when creating Azure Arc VMs](./create-arc-virtual-machines.md#create-arc-vms).
0 commit comments