mobilityManagementPolicy resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

In Microsoft Entra ID, a mobility management policy represents an autoenrollment configuration for a mobility management (MDM or MAM) application. These policies are only applicable to devices based on Windows 10 OS and its derivatives (Surface Hub, HoloLens etc.). Autoenrollment enables organizations to automatically enroll devices into their chosen mobility management application as part of Microsoft Entra join or Microsoft Entra register process on Windows 10 devices.

Methods

Method Return type Description
Mobile device management policy
List mobilityManagementPolicy collection Get a list of the mobilityManagementPolicy objects and their properties for mobile device management applications.
Get mobilityManagementPolicy Read the properties and relationships of a mobilityManagementPolicy object for a mobile device management application.
Update None Update the properties of a mobilityManagementPolicy object for a mobile device management application.
List included groups group collection List included groups for a mobilityManagementPolicy object for a mobile device management application.
Add group to policy None Add a group to the mobilityManagementPolicy object for a mobile device management application.
Delete group from policy None Delete a group from the mobilityManagementPolicy object for a mobile device management application.
Mobile app management policy
List mobilityManagementPolicy collection Get a list of the mobilityManagementPolicy objects and their properties for mobile app management applications.
Get mobilityManagementPolicy Read the properties and relationships of a mobilityManagementPolicy object for a mobile app management application.
Update None Update the properties of a mobilityManagementPolicy object for a mobile app management application.
List included groups group collection List included groups for a mobilityManagementPolicy object for a mobile app management application.
Add group to policy None Add a group to the mobilityManagementPolicy object for a mobile app management application.
Delete group from policy None Delete a group from the mobilityManagementPolicy object for a mobile app management application.

Properties

Property Type Description
appliesTo policyScope Indicates the user scope of the mobility management policy. Possible values are: none, all, selected.
complianceUrl String Compliance URL of the mobility management application.
description String Description of the mobility management application.
discoveryUrl String Discovery URL of the mobility management application.
displayName String Display name of the mobility management application.
id String Object Id of the mobility management application.
isValid Boolean Whether policy is valid. Invalid policies may not be updated and should be deleted.
termsOfUseUrl String Terms of Use URL of the mobility management application.

Relationships

Relationship Type Description
includedGroups group collection Microsoft Entra groups under the scope of the mobility management application if appliesTo is selected

JSON representation

The following JSON representation shows the resource type.

{
  "id": "String (identifier)",
  "appliesTo": "String",
  "complianceUrl": "String",
  "description": "String",
  "discoveryUrl": "String",
  "displayName": "String",
  "isValid": "Boolean",
  "termsOfUseUrl": "String"
}