Edit

Share via

deviceManagementSettingDefinition resource type

Namespace: microsoft.graph

Important: APIs under the /beta version in Microsoft Graph are subject to change which could break your applications. While Intune /beta APIs are supported by Microsoft, you should use these at your own discretion. In general, /beta APIs are not recommended for use in production applications. To determine whether an API is available in v1.0, use the Version selector

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

Entity representing the defintion for a given setting

Methods

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

Properties

Property Type Description
id String The ID of the setting definition
valueType deviceManangementIntentValueType The data type of the value. Possible values are: integer, boolean, string, complex, collection, abstractComplex.
displayName String The setting's display name
isTopLevel Boolean If the setting is top level, it can be configured without the need to be wrapped in a collection or complex setting
description String The setting's description
placeholderText String Placeholder text as an example of valid input
documentationUrl String Url to setting documentation
headerTitle String title of the setting header represents a category/section of a setting/settings
headerSubtitle String subtitle of the setting header for more details about the category/section
keywords String collection Keywords associated with the setting
constraints deviceManagementConstraint collection Collection of constraints for the setting value
dependencies deviceManagementSettingDependency collection Collection of dependencies on other settings

Relationships

None

JSON Representation

Here is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.deviceManagementSettingDefinition",
  "id": "String (identifier)",
  "valueType": "String",
  "displayName": "String",
  "isTopLevel": true,
  "description": "String",
  "placeholderText": "String",
  "documentationUrl": "String",
  "headerTitle": "String",
  "headerSubtitle": "String",
  "keywords": [
    "String"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "String"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "String",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "String"
          ]
        }
      ]
    }
  ]
}