Adding docs for Shared Maintenance Window

[Anushka Singh (anushkasingh16)]

Summary

Adds public preview documentation for linking AKS maintenance configurations to a shared MaintenanceWindow resource.

Changes

• Adds CLI guidance for installing/updating the aks-preview extension.
• Adds subscription-scoped feature registration steps for AKSSharedMaintenanceWindowPreview.
• Documents how to link aksManagedAutoUpgradeSchedule or aksManagedNodeOSUpgradeSchedule to a shared maintenance window using --maintenance-window-id.
• Documents validation constraints:
  • --maintenance-window-id can’t be combined with inline schedule arguments.
  • --maintenance-window-id can’t be combined with --config-file.
  • JSON config files should use the maintenanceWindowId property instead.

Notes for reviewers

This draft assumes the shared Microsoft.ContainerService/maintenanceWindows resource already exists.

[prmerger-automator]

Anushka Singh (@anushkasingh16) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

[prmerger-automator]

Anushka Singh (@anushkasingh16) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

[learn-build-service-prod]

Learn Build status updates of commit 54a2607:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/aks/planned-maintenance.md	✅Succeeded

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit b98c60c:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/aks/planned-maintenance.md	✅Succeeded

For more details, please refer to the build report.

[Regan Downer (v-regandowner)]

Erin Schaffer (@schaffererin)

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

[Copilot]

Pull request overview

Adds public preview documentation to planned-maintenance.md describing how to create and use a subscription/resource-group scoped shared Microsoft.ContainerService/maintenanceWindows resource and link it to AKS maintenance configurations via --maintenance-window-id / maintenanceWindowId.

Changes:

• Adds a new “Use a shared maintenance window (preview)” section with prerequisites, creation via az rest, linking via az aks maintenanceconfiguration add|update, and unlink/delete guidance.
• Adds CLI feature registration steps for AKSSharedMaintenanceWindowPreview and new link references.
• Adds ai-usage: ai-assisted front matter and updates ms.date.

Suppressed comments (1)

articles/aks/planned-maintenance.md:762

• This JSON example uses maintenanceWindows/myWindow, but the earlier az rest examples create maintenanceWindows/mySharedWindow. Use a consistent shared maintenance window name across examples.

    "maintenanceConfigurationType": "aksManagedAutoUpgradeSchedule",
    "maintenanceWindowId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.ContainerService/maintenanceWindows/myWindow"
  }

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[learn-build-service-prod]

Learn Build status updates of commit 98aa94c:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/aks/planned-maintenance.md	✅Succeeded

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit 3f4233d:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/aks/planned-maintenance.md	✅Succeeded

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit 875de27:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/aks/planned-maintenance.md	✅Succeeded

For more details, please refer to the build report.

[ibaboulfetouh]

Thanks Anushka Singh (@anushkasingh16) !

[learn-build-service-prod]

Learn Build status updates of commit 1b5f603:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
articles/aks/security-controls-policy.md	❌Error		Details

articles/aks/security-controls-policy.md

• Line 21, Column 1: [Error: include-not-found - See documentation] Invalid include link: '~/azure-docs-pr/includes/policy/standards/intro-warning.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.