Skip to content

Commit eef476c

Browse files
MutemwaRMashekemichaeltlombardi
authored andcommitted
Separate release notes for machine configuration
Prior to this change, the release notes for the Azure machine configuration agent were kept in the `agents.md` file, colocating the notes for releases on Windows and Linux in the same document. This made it difficult for users to navigate to the correct release and wasn't intuitive for discovery and reading. This change: - Separates the release notes by platform, making it easier to find the correct release for a platform. - Adds anchors to each article to simplify linking to a specific version or release date. - Replaces `agent.md` with `agent/index.md` as an overview to direct readers to the platform-specific release notes. This obviates needing a redirection as the URL remains valid. - Fixes some minor grammar and formatting for the release notes.
1 parent 4db51c5 commit eef476c

6 files changed

Lines changed: 475 additions & 304 deletions

File tree

articles/governance/machine-configuration/toc.yml

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,14 @@ items:
1919

2020
- name: What's new in Machine Configuration
2121
items:
22-
- name: What's new in the agent
23-
href: ./whats-new/agent.md
22+
- name: What's new in the Azure machine configuration agent
23+
items:
24+
- name: Overview
25+
href: ./whats-new/agent/index.md
26+
- name: Windows agent release notes
27+
href: ./whats-new/agent/windows.md
28+
- name: Linux agent release notes
29+
href: ./whats-new/agent/linux.md
2430
# Planned, not yet written
2531
# - name: What's new in the service
2632
# href: ./whats-new/service.md

articles/governance/machine-configuration/whats-new/agent.md

Lines changed: 0 additions & 300 deletions
This file was deleted.
Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
title: Azure machine configuration agent release notes overview
3+
description: >-
4+
Overview of the guest configuration agent release notes, issues, and frequently asked questions.
5+
ms.date: 04/13/2026
6+
ms.topic: release-notes
7+
---
8+
9+
# Azure machine configuration agent release notes overview
10+
11+
The machine configuration agent receives improvements on an ongoing basis. To stay up to date with
12+
the most recent developments by platform, see the following articles:
13+
14+
- [Azure machine configuration agent for Linux release notes][01]
15+
(`Microsoft.GuestConfiguration.ConfigurationforWindows`)
16+
- [Azure machine configuration agent for Windows release notes][02]
17+
(`Microsoft.GuestConfiguration.ConfigurationforLinux`)
18+
19+
Each article provides you with information about:
20+
21+
- The latest releases
22+
- Known issues
23+
- Bug fixes
24+
25+
For information on release notes for the connected machine agent, see
26+
[What's new with the connected machine agent][03].
27+
28+
## Release timeline
29+
30+
The following table shows the releases for both platforms from most recent to oldest. Each entry
31+
includes a direct link to the relevant release for more information.
32+
33+
| Platform | Version | Release date | Link |
34+
|:--------:|:------------:|:--------------:|:----------------------------------------:|
35+
| Linux | `1.26.104.0` | January 2026 | [Release notes](./linux.md#1.26.104.0) |
36+
| Windows | `1.29.104.0` | January 2026 | [Release notes](./windows.md#1.29.104.0) |
37+
| Linux | `1.26.101.0` | November 2025 | [Release notes](./linux.md#1.26.101.0) |
38+
| Windows | `1.29.101.0` | November 2025 | [Release notes](./windows.md#1.29.101.0) |
39+
| Linux | `1.26.93.0` | July 2025 | [Release notes](./linux.md#1.26.93.0) |
40+
| Windows | `1.29.98.0` | July 2025 | [Release notes](./windows.md#1.29.98.0) |
41+
| Linux | `1.26.87` | April 2025 | [Release notes](./linux.md#1.26.87) |
42+
| Windows | `1.29.92.0` | April 2025 | [Release notes](./windows.md#1.29.92.0) |
43+
| Linux | `1.26.85` | March 2025 | [Release notes](./linux.md#1.26.85) |
44+
| Windows | `1.29.91.0` | March 2025 | [Release notes](./windows.md#1.29.91.0) |
45+
| Linux | `1.26.80` | January 2025 | [Release notes](./linux.md#1.26.80) |
46+
| Windows | `1.29.86.0` | January 2025 | [Release notes](./windows.md#1.29.86.0) |
47+
| Linux | `1.26.79` | October 2024 | [Release notes](./linux.md#1.26.79) |
48+
| Windows | `1.29.85.0` | October 2024 | [Release notes](./windows.md#1.29.85.0) |
49+
| Linux | `1.26.77` | September 2024 | [Release notes](./linux.md#1.26.77) |
50+
| Linux | `1.26.76` | September 2024 | [Release notes](./linux.md#1.26.76) |
51+
| Windows | `1.29.82.0` | September 2024 | [Release notes](./windows.md#1.29.82.0) |
52+
| Linux | `1.26.47` | January 2023 | [Release notes](./linux.md#1.26.76) |
53+
| Linux | `1.26.38` | - | [Release notes](./linux.md#1.26.76) |
54+
55+
## Next steps
56+
57+
- Set up a custom machine configuration package [development environment][04].
58+
- [Create a package artifact][05] for machine configuration.
59+
- [Test the package artifact][06] from your development environment.
60+
- Use the `GuestConfiguration` module to [create an Azure Policy definition][07] for at-scale
61+
management of your environment.
62+
- [Assign your custom policy definition][08] using Azure portal.
63+
- Learn how to view [compliance details for machine configuration][09] policy assignments.
64+
65+
<!-- Reference link definitions -->
66+
[01]: ./windows.md
67+
[02]: ./linux.md
68+
[03]: /azure/azure-arc/servers/agent-release-notes
69+
[04]: ../../how-to/develop-custom-package/1-set-up-authoring-environment.md
70+
[05]: ../../how-to/develop-custom-package/2-create-package.md
71+
[06]: ../../how-to/develop-custom-package/3-test-package.md
72+
[07]: ../../how-to/create-policy-definition.md
73+
[08]: ../../../policy/assign-policy-portal.md
74+
[09]: ../../../policy/how-to/determine-non-compliance.md

0 commit comments

Comments
 (0)