Azure machine configuration agent release notes

About the machine configuration agent

The machine configuration agent receives improvements on an ongoing basis. To stay up to date with the most recent developments, this article provides you with information about:

  • The latest releases
  • Known issues
  • Bug fixes

For information on release notes for the connected machine agent, see What's new with the connected machine agent.

Release notes

Version 1.26.48 - January 2023

New Features

  • In this release, we've added support for Linux distributions such as Red Hat Enterprise Linux (RHEL) 9, Mariner 1&2, Alma 9, and Rocky 9.


  • Reliability improvements were made to the guest configuration policy engine

Guest Configuration Linux Extension version 1.26.38

In this release, various improvements were made.

  • You can now restrict which URLs can be used to download machine configuration packages by setting the allowedGuestConfigPkgUrls tag on the server resource and providing a comma-separated list of URL patterns to allow. If the tag exists, the agent only allows custom packages to be downloaded from the specified URLs. Built-in packages are unaffected by this feature.


  • Resolves local elevation of privilege vulnerability CVE-2022-38007.
  • If you're currently running an older version of the AzurePolicyforLinux extension, use the PowerShell or Azure CLI commands in the following examples to update your extension to the latest version.
$params = @{
    Publisher              = 'Microsoft.GuestConfiguration'
    Type                   = 'ConfigurationforLinux'
    Name                   = 'AzurePolicyforLinux'
    TypeHandlerVersion     = '1.26.38'
    ResourceGroupName      = '<resource-group>'
    Location               = '<location>'
    VMName                 = '<vm-name>'
    EnableAutomaticUpgrade = $true
Set-AzVMExtension @params
az vm extension set \
    --publisher Microsoft.GuestConfiguration \
    --name ConfigurationforLinux \
    --extension-instance-name AzurePolicyforLinux \
    --resource-group <resource-group> \
    --vm-name <vm-name> \
    --version 1.26.38 \
    --enable-auto-upgrade true

Next steps