MC955748 – Updates to Graph Beta APIs for Windows Endpoint security policies and Administrative templates (archived)

Intune Icon

check before: 2025-03-31

Product:

Intune, Microsoft Graph

Platform:

Developer, Online, World tenant

Status:

Change type:

Admin impact

Links:

Details:

Summary:
Starting March 2025, certain Microsoft Graph Beta APIs will no longer support creating/managing Endpoint security policies and Administrative templates for Windows devices. Users must update IT documentation and scripts to use the deviceManagement/configurationPolicies API instead. For details, refer to the provided blog link.

Details:
Starting late March 2025, the Microsoft Graph Beta APIs deviceManagement/templates and deviceManagement/intents will no longer support the ability to create and manage Endpoint security policies for Windows devices. Additionally, the following Beta APIs will no longer work for managing Administrative templates: deviceManagement/groupPolicyCategories, deviceManagement/groupPolicyConfigurations, and deviceManagement/groupPolicyDefinitions.


For a full list of affected policies, refer to the blog: https://aka.ms/Intune/Windows-API-updates

Change Category:
XXXXXXX ... free basic plan only

Scope:
XXXXXXX ... free basic plan only

Release Phase:

Created:
2024-12-13

updated:
2024-12-13

Task Type

XXXXXXX ... free basic plan only

Docu to Check

XXXXXXX ... free basic plan only

MS How does it affect me

XXXXXXX ... free basic plan only

MS Preperations

XXXXXXX ... free basic plan only

MS Urgency

XXXXXXX ... free basic plan only

MS workload name

XXXXXXX ... free basic plan only

summary for non-techies**

Starting March 2025, Microsoft Graph Beta APIs for managing Windows Endpoint security policies and Administrative templates, specifically deviceManagement/templates and deviceManagement/intents, will be deprecated, requiring IT teams to transition to the deviceManagement/configurationPolicies API for these functions.

Direct effects for Operations**

API Deprecation
Failure to transition to the new deviceManagement/configurationPolicies API will result in inability to create/manage Endpoint security policies, leading to potential security vulnerabilities.
   - roles: IT Administrators, Security Analysts
   - references: https://aka.ms/Intune/Windows-API-updates

Documentation Updates
Outdated IT documentation may lead to confusion and errors in policy management, impacting operational efficiency.
   - roles: IT Administrators, Support Staff
   - references: https://aka.ms/Intune/Windows-API-updates

Script Failures
Existing automation scripts relying on deprecated APIs will fail, causing disruptions in policy deployment and management.
   - roles: DevOps Engineers, IT Administrators
   - references: https://learn.microsoft.com/graph/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-get?view=graph-rest-beta

User Experience Degradation
Inability to manage security policies may lead to inconsistent user experiences and potential security risks for end-users.
   - roles: End Users, IT Support
   - references: https://learn.microsoft.com/graph/api/intune-deviceintent-devicemanagementintent-list?view=graph-rest-beta

Increased Support Tickets
Users may experience issues due to unaddressed policy changes, leading to an increase in support requests and operational burden.
   - roles: IT Support, Helpdesk Staff
   - references: https://learn.microsoft.com/graph/api/intune-grouppolicy-grouppolicydefinition-get?view=graph-rest-beta

Configutation Options**

XXXXXXX ... paid membership only

Opportunities**

API Transition Planning
Transitioning from deprecated Beta APIs to the deviceManagement/configurationPolicies API can streamline management processes and enhance system stability. This opportunity allows for better performance and reliability of endpoint security policies and administrative templates.
   - next-steps: Develop a migration plan that includes updating documentation and scripts. Schedule training sessions for the IT team to familiarize them with the new API functionalities.
   - roles: IT Administrators, DevOps Engineers, Security Analysts
   - references: https://learn.microsoft.com/graph/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-get?view=graph-rest-beta, https://learn.microsoft.com/graph/api/intune-deviceintent-devicemanagementintent-list?view=graph-rest-beta

Documentation Improvement
Updating IT documentation to reflect the changes in API usage can improve knowledge sharing and operational efficiency. Clear documentation helps in onboarding new staff and serves as a reference for existing employees.
   - next-steps: Review current documentation for outdated references, and create new documents that outline the usage of the deviceManagement/configurationPolicies API. Implement a review process for future updates.
   - roles: Technical Writers, IT Administrators, Compliance Officers
   - references: https://aka.ms/Intune/Windows-API-updates

Automation Enhancements
By utilizing the deviceManagement/configurationPolicies API, organizations can enhance automation capabilities for managing endpoint security and administrative templates. This can lead to reduced manual workload and faster response times.
   - next-steps: Identify current automation scripts that need modification. Update these scripts to leverage the new API and test them thoroughly to ensure functionality. Consider implementing a CI/CD pipeline for ongoing updates.
   - roles: DevOps Engineers, IT Administrators, Automation Specialists
   - references: https://learn.microsoft.com/graph/api/intune-deviceintent-devicemanagementtemplate-list?view=graph-rest-beta, https://learn.microsoft.com/graph/api/intune-grouppolicy-grouppolicydefinition-get?view=graph-rest-beta

Potentional Risks**

XXXXXXX ... paid membership only

IT Security**

XXXXXXX ... paid membership only

explanation for non-techies**

XXXXXXX ... free basic plan only

** AI generated content. This information must be reviewed before use.

a free basic plan is required to see more details. Sign up here


A cloudsocut.one plan is required to see all the changed details. If you are already a customer, choose login.
If you are new to cloudscout.one please choose a plan.



Last updated 2 weeks ago

Share to MS Teams

Login to your account

Welcome Back, We Missed You!