deviceManagementIntent resource type

Namespace: microsoft.graph

Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Entity that represents an intent to apply settings to a device

Methods

Method	Return Type	Description
List deviceManagementIntents	deviceManagementIntent collection	List properties and relationships of the deviceManagementIntent objects.
Get deviceManagementIntent	deviceManagementIntent	Read properties and relationships of the deviceManagementIntent object.
Create deviceManagementIntent	deviceManagementIntent	Create a new deviceManagementIntent object.
Delete deviceManagementIntent	None	Deletes a deviceManagementIntent.
Update deviceManagementIntent	deviceManagementIntent	Update the properties of a deviceManagementIntent object.
updateSettings action	None
migrateToTemplate action	None
createCopy action	deviceManagementIntent
assign action	None
compare function	deviceManagementSettingComparison collection
getCustomizedSettings function	deviceManagementIntentCustomizedSetting collection

Properties

Property	Type	Description
id	String	The intent ID
displayName	String	The user given display name
description	String	The user given description
isAssigned	Boolean	Signifies whether or not the intent is assigned to users
isMigratingToConfigurationPolicy	Boolean	Signifies whether or not the intent is being migrated to the configurationPolicies endpoint
lastModifiedDateTime	DateTimeOffset	When the intent was last modified
templateId	String	The ID of the template this intent was created from (if any)
roleScopeTagIds	String collection	List of Scope Tags for this Entity instance.

Relationships

Relationship	Type	Description
settings	deviceManagementSettingInstance collection	Collection of all settings to be applied
categories	deviceManagementIntentSettingCategory collection	Collection of setting categories within the intent
assignments	deviceManagementIntentAssignment collection	Collection of assignments
deviceSettingStateSummaries	deviceManagementIntentDeviceSettingStateSummary collection	Collection of settings and their states and counts of devices that belong to corresponding state for all settings within the intent
deviceStates	deviceManagementIntentDeviceState collection	Collection of states of all devices that the intent is applied to
userStates	deviceManagementIntentUserState collection	Collection of states of all users that the intent is applied to
deviceStateSummary	deviceManagementIntentDeviceStateSummary	A summary of device states and counts of devices that belong to corresponding state for all devices that the intent is applied to
userStateSummary	deviceManagementIntentUserStateSummary	A summary of user states and counts of users that belong to corresponding state for all users that the intent is applied to

JSON Representation

Here is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.deviceManagementIntent",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "isAssigned": true,
  "isMigratingToConfigurationPolicy": true,
  "lastModifiedDateTime": "String (timestamp)",
  "templateId": "String",
  "roleScopeTagIds": [
    "String"
  ]
}