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"
]
}