Edit

Share via

deviceManagementSettingDefinition resource type

Namespace: microsoft.graph

Important: Microsoft supports Intune /beta APIs, but they are subject to more frequent change. Microsoft recommends using version v1.0 when possible. Check an API's availability in version v1.0 using 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"
          ]
        }
      ]
    }
  ]
}