deviceManagementConfigurationSettingDefinition 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.

Methods

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

Properties

Property	Type	Description
applicability	deviceManagementConfigurationSettingApplicability	Details which device setting is applicable on. Supports: $filters.
accessTypes	deviceManagementConfigurationSettingAccessTypes	Read/write access mode of the setting. Possible values are: none, add, copy, delete, get, replace, execute.
keywords	String collection	Tokens which to search settings on
infoUrls	String collection	List of links more info for the setting can be found at.
occurrence	deviceManagementConfigurationSettingOccurrence	Indicates whether the setting is required or not
baseUri	String	Base CSP Path
offsetUri	String	Offset CSP Path from Base
rootDefinitionId	String	Root setting definition id if the setting is a child setting.
categoryId	String	Specify category in which the setting is under. Support $filters.
settingUsage	deviceManagementConfigurationSettingUsage	Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: none, configuration, compliance, unknownFutureValue, inventory.
uxBehavior	deviceManagementConfigurationControlType	Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane, unknownFutureValue.
visibility	deviceManagementConfigurationSettingVisibility	Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: none, settingsCatalog, template, unknownFutureValue, inventoryCatalog.
referredSettingInformationList	deviceManagementConfigurationReferredSettingInformation collection	List of referred setting information.
id	String	Identifier for item
description	String	Description of the setting.
helpText	String	Help text of the setting. Give more details of the setting.
name	String	Name of the item
displayName	String	Name of the setting. For example: Allow Toast.
version	String	Item Version

Relationships

None

JSON Representation

Here is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "String",
    "platform": "String",
    "deviceMode": "String",
    "technologies": "String"
  },
  "accessTypes": "String",
  "keywords": [
    "String"
  ],
  "infoUrls": [
    "String"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 1024,
    "maxDeviceOccurrence": 1024
  },
  "baseUri": "String",
  "offsetUri": "String",
  "rootDefinitionId": "String",
  "categoryId": "String",
  "settingUsage": "String",
  "uxBehavior": "String",
  "visibility": "String",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "String"
    }
  ],
  "id": "String (identifier)",
  "description": "String",
  "helpText": "String",
  "name": "String",
  "displayName": "String",
  "version": "String"
}