deviceConfigurationState resource type

Important: APIs under the / beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported. Note: Using the Microsoft Graph APIs to configure Intune controls and policies still requires that the Intune service is correctly licensed by the customer.

Device Configuration State for a given device.


Method Return Type Description
List deviceConfigurationStates deviceConfigurationState collection List properties and relationships of the deviceConfigurationState objects.
Get deviceConfigurationState deviceConfigurationState Read properties and relationships of the deviceConfigurationState object.
Create deviceConfigurationState deviceConfigurationState Create a new deviceConfigurationState object.
Delete deviceConfigurationState None Deletes a deviceConfigurationState.
Update deviceConfigurationState deviceConfigurationState Update the properties of a deviceConfigurationState object.


Property Type Description
id String Key of the entity.
settingStates deviceConfigurationSettingState collection Not yet documented
displayName String The name of the policy for this policyBase
version Int32 The version of the policy
platformType String Platform type that the policy applies to Possible values are: android, androidForWork, iOS, macOS, windowsPhone81, windows81AndLater, windows10AndLater, all.
state String The compliance state of the policy Possible values are: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict.
settingCount Int32 Count of how many setting a policy holds



JSON Representation

Here is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.deviceConfigurationState",
  "id": "String (identifier)",
  "settingStates": [
      "@odata.type": "microsoft.graph.deviceConfigurationSettingState",
      "setting": "String",
      "settingName": "String",
      "instanceDisplayName": "String",
      "state": "String",
      "errorCode": 1024,
      "errorDescription": "String",
      "userId": "String",
      "userName": "String",
      "userEmail": "String",
      "userPrincipalName": "String",
      "sources": [
          "@odata.type": "microsoft.graph.settingSource",
          "id": "String",
          "displayName": "String"
      "currentValue": "String"
  "displayName": "String",
  "version": 1024,
  "platformType": "String",
  "state": "String",
  "settingCount": 1024