Manage VM extensions on Azure Stack HCI virtual machines

Applies to: Azure Stack HCI, version 23H2

This article describes how to install and manage VM extensions on your Azure Stack HCI via the Azure portal.

The VM extensions on your Azure Arc VMs on Azure Stack HCI are useful for post-deployment configuration, software installation, or other management tasks. To install VM extensions, you must enable Azure guest management on your Arc VMs.

Supported VM extensions

For a full list of supported VM extensions, see:

Prerequisites

Before you install and manage VM extensions, make sure that:

  • You’ve access to an Arc VM running on your Azure Stack HCI and the VM has guest management enabled. Guest management is supported on Windows and Linux VMs. For more information on how to create an Arc VM, see Create Arc VMs on your Azure Stack HCI cluster.

Verify guest management is enabled

To manage VMs on Azure Stack HCI, you must enable guest management on the VMs. When you enable guest management, an agent is installed on the VM.

You must verify that guest management is enabled on your VMs before you install VM extensions.

Note

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 Arc VMs, see Create Arc VMs in Azure Stack HCI.

Follow these steps to verify that guest management is enabled using the Azure portal.

  1. In the Azure portal of your Azure Stack HCI cluster resource, go to Resources > Virtual machines.

  2. From the list of the VMs displayed in the right-pane, select the VM where you’ll install the extension.

  3. In the Overview blade, under Properties > Configuration, verify that the Guest management shows as Enabled.

    Screenshot showing guest management as enabled in the selected Arc-enabled VM.

Add VM extension

After the guest management enablement is verified, you can now add the VM extension.

Follow these steps in Azure portal to add a VM extension.

  1. In the Azure portal of your Azure Stack HCI cluster resource, go to Resources > Virtual machines.

  2. Select your VM and go to Settings > Extensions.

  3. From the top of the command bar in the right-pane, select + Add.

    Screenshot showing + Add selected to add an extension in the chosen Arc VM.

  4. In the Install extension, choose from the available extensions. In this example, we'll deploy the Azure Monitor Agent for Windows (Recommended).

    Screenshot showing the Azure Monitor Extension selected in the chosen Arc VM.

  5. Provide the parameters to configure the selected VM extension.

    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.

    Screenshot showing configuration of Azure Monitor Extension installation in the chosen Arc VM.

  6. Select Review + Create.

The extension might take a few minutes to install. After the extension is installed, the list refreshes to display the newly installed extension.

List installed extensions

You can get a list of all the VM extensions installed on your Azure Stack HCI cluster.

Follow these steps in Azure portal to list the installed VM extensions.

  1. In the Azure portal of your Azure Stack HCI cluster resource, go to Resources > Virtual machines.

  2. Select your VM and select Extensions.

  3. In the right pane, you can view the list of extensions on your VM.

    Screenshot showing the list of installed extensions for the chosen Arc-enabled VM.

Delete VM extension

You might want to delete a VM extension if the installation fails for some reason or if the extension is no longer needed.

  1. In the Azure portal of your Azure Stack HCI cluster resource, go to Resources > Virtual machines.

  2. Select your VM and select Extensions.

  3. 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.

    In this example, AzureMonitorWindowsAgent is selected.

    Screenshot showing Uninstall selected for the chosen Arc-enabled VM.

The extension should take a couple minutes for removal.

Next steps

Learn how to: