Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Warning
Effective January 2026, the Azure Connected Machine agent will no longer accept certificates with negative serial numbers, in compliance with RFC 5280 Section 4.1.2.2, which states that "the serial number MUST be a positive integer assigned by the CA to each certificate."
The Azure Connected Machine 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
This page is updated monthly, so revisit it regularly. If you're looking for items older than six months, you can find them in archive for What's new with Azure Connected Machine agent.
Warning
Only Connected Machine agent versions released within the last year are officially supported by the product group. Customers should update to an agent version within this window. Microsoft recommends staying up to date with the latest agent version whenever possible.
Warning
For Windows Server 2012 Machines, Agents 1.50 and 1.51 fail to install or upgrade. Microsoft is working to resolve this in May 2025 Agent release or sooner.
Version 1.52 - May 2025
Fixed
- Fixed a bug in the installer where the installation would fail if the TPM udev rule could not be created.
New features and enhancements
Added
--include-all
flag toazcmagent check
to enable network checks beyond onboarding scenarios.[Linux Only] GC 1.26.90.0: Added HIMDS as a dependent service for the Extension service.
[Linux Only] Added
journalctl
logs to the.zip
generated byazcmagent logs
.[Windows Only] GC 1.29.95.0: Added dependent DLLs needed to support Windows Server 2012.
[Windows Only] Added Windows Event Logs to the
.zip
generated byazcmagent logs
.
Version 1.51 - April 2025
Fixed
Extension Delete improvements to ensure removal requests are always attempted irrespective of Version mismatches and other out of sync cases
Redacted upstream proxy data before sending configuration details to HIS to enhance security.
New features and enhancements
Updated Dependencies
- Upgraded to PowerShell 7.4.7
- Upgraded to .NET 8.0
IP address caching to reduce excessive DNS resolver calls.
[Windows only] Optimized PayGo processing for improved efficiency.
Enabled Arc proxy to run by default
Added detection for SCCM and SCOM
Enhanced logging with security annotations in
azcmagent
andhimds
logs.
Version 1.50 - March 2025
Fixed
- If an extension package fails to download 10 times, the download request will fail instead of continuing until timeout.
- Fixed a deadlock issue in the Policy agent that occurred in certain edge cases.
New features and enhancements
- Tags Input: Now supports escaped characters using backslashes when running
azcmagent connect
. - Location Flag: Automatically removes spaces from user-provided values for
--___location
. - Request Logging: The optional
Client-Id
header is now logged for requests made to HIMDS.
Version 1.49 - February 2025
Fixed
- Added retry logic for reading the status file before sending a report if the agent fails to deserialize it the first time.
- Suppressed terminal error due to a certificate having a negative serial number. This error will be reenabled in January 2026; customers should update their certificates before then, especially if using SSL inspection.
New features and enhancements
- Increased package size limit for AMA only.
- Preserved
HandlerManifest.json
file during deletion to prevent extension removal failures. - Added detection for PostgreSQL and MySQL.
- Compressed archived logs.
- Display certificate chain information for failed requests (if the TLS handshake reaches the cert stage).
- Display absolute path for log zip files to improve visibility.
- Updated recommended actions for failures to reach Service endpoints.
- Windows only:
- The agent now saves MSI certificates both on disk and in the Windows cert store (only for Windows Servers 2019 (10.0.17763) and newer).
- Added authentication option to use certificates from the Windows cert store for
azcmagent connect
andazcmagent disconnect
.
Version 1.48 - January 2025
Fixed
- Addressed a security issue related to Redirection Guard.
- Resolved a bug that caused issues during the upgrade of the RunCommand extension.
- Fixed high port usage in the Azure Arc proxy.
- Fixed an issue with the Alma Linux install script.
- Improved handling of disassociated Gateway URLs.
- Resolved an issue with disk space queries.
- Improved HIMDS behavior when IMDS data is unavailable.
New features and enhancements
- Added support for extension telemetry.
- Updated the OpenSSL library for security enhancements.
- Improved error reporting for
azcmagent
commands. - Increased connectivity check timeout for better reliability.
- Expanded ARM64 platform support to include RHEL 9.
- Updated the
mssqldiscovered
property to include the detection for SQL Server Integration, Analysis, and Reporting services (SSIS, SSAS, SSRS and PBIRS). - Introduced a scheduled task that checks for agent updates on a daily basis. Currently, the update mechanism is inactive and no changes are made to your server even if a newer agent version is available.
Version 1.47 - October 2024
Fixed
- Guest Configuration: Fix an issue that caused agent to become unresponsive.
- Fixed a bug to trim error messages when updating AgentStatus.
New features and enhancements
- Code enhancement to support cloud specific endpoints in the install script.
- Addition of architecture detection to system properties.
- Addition of EndpointConnectivityInfo to AgentData.
- Expansion of ARM64 platform support for the following distributions:
- Ubuntu 20.04, 22.04, 24.04
- Azure Linux (CBL-Mariner) 2.0
- Amazon Linux 2
- Alma Linux 8
Note
This article contains updates covering the past six months. For earlier releases, see Archive for What's new with Azure Connected Machine agent
Next steps
- Before evaluating or enabling Azure Arc-enabled servers across multiple hybrid machines, read Connected Machine agent overview to understand requirements, technical details about the agent, and deployment methods.
- Review the Planning and deployment guide to plan for deploying Azure Arc-enabled servers at any scale and implement centralized management and monitoring.