deviceManagementConfigurationChoiceSettingDefinition 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.
Inherits from deviceManagementConfigurationSettingDefinition
Methods
| Method | Return Type | Description |
|---|---|---|
| List deviceManagementConfigurationChoiceSettingDefinitions | deviceManagementConfigurationChoiceSettingDefinition collection | List properties and relationships of the deviceManagementConfigurationChoiceSettingDefinition objects. |
| Get deviceManagementConfigurationChoiceSettingDefinition | deviceManagementConfigurationChoiceSettingDefinition | Read properties and relationships of the deviceManagementConfigurationChoiceSettingDefinition object. |
| Create deviceManagementConfigurationChoiceSettingDefinition | deviceManagementConfigurationChoiceSettingDefinition | Create a new deviceManagementConfigurationChoiceSettingDefinition object. |
| Delete deviceManagementConfigurationChoiceSettingDefinition | None | Deletes a deviceManagementConfigurationChoiceSettingDefinition. |
| Update deviceManagementConfigurationChoiceSettingDefinition | deviceManagementConfigurationChoiceSettingDefinition | Update the properties of a deviceManagementConfigurationChoiceSettingDefinition object. |
Properties
| Property | Type | Description |
|---|---|---|
| applicability | deviceManagementConfigurationSettingApplicability | Details which device setting is applicable on. Supports: $filters. Inherited from deviceManagementConfigurationSettingDefinition |
| accessTypes | deviceManagementConfigurationSettingAccessTypes | Read/write access mode of the setting Inherited from deviceManagementConfigurationSettingDefinition. Possible values are: none, add, copy, delete, get, replace, execute. |
| keywords | String collection | Tokens which to search settings on Inherited from deviceManagementConfigurationSettingDefinition |
| infoUrls | String collection | List of links more info for the setting can be found at. Inherited from deviceManagementConfigurationSettingDefinition |
| occurrence | deviceManagementConfigurationSettingOccurrence | Indicates whether the setting is required or not Inherited from deviceManagementConfigurationSettingDefinition |
| baseUri | String | Base CSP Path Inherited from deviceManagementConfigurationSettingDefinition |
| offsetUri | String | Offset CSP Path from Base Inherited from deviceManagementConfigurationSettingDefinition |
| rootDefinitionId | String | Root setting definition id if the setting is a child setting. Inherited from deviceManagementConfigurationSettingDefinition |
| categoryId | String | Specify category in which the setting is under. Support $filters. Inherited from deviceManagementConfigurationSettingDefinition |
| settingUsage | deviceManagementConfigurationSettingUsage | Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from deviceManagementConfigurationSettingDefinition. 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. Inherited from deviceManagementConfigurationSettingDefinition. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane, unknownFutureValue. |
| visibility | deviceManagementConfigurationSettingVisibility | Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from deviceManagementConfigurationSettingDefinition. Possible values are: none, settingsCatalog, template, unknownFutureValue, inventoryCatalog. |
| referredSettingInformationList | deviceManagementConfigurationReferredSettingInformation collection | List of referred setting information. Inherited from deviceManagementConfigurationSettingDefinition |
| id | String | Identifier for item Inherited from deviceManagementConfigurationSettingDefinition |
| description | String | Description of the setting. Inherited from deviceManagementConfigurationSettingDefinition |
| helpText | String | Help text of the setting. Give more details of the setting. Inherited from deviceManagementConfigurationSettingDefinition |
| name | String | Name of the item Inherited from deviceManagementConfigurationSettingDefinition |
| displayName | String | Name of the setting. For example: Allow Toast. Inherited from deviceManagementConfigurationSettingDefinition |
| version | String | Item Version Inherited from deviceManagementConfigurationSettingDefinition |
| options | deviceManagementConfigurationOptionDefinition collection | Options for the setting that can be selected. |
| defaultOptionId | String | Default option for the choice setting. |
Relationships
None
JSON Representation
Here is a JSON representation of the resource.
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationChoiceSettingDefinition",
"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",
"options": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationOptionDefinition",
"optionValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationGroupSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "String",
"useTemplateDefault": true
},
"value": "String",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "String",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "String"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": null,
"value": "String",
"children": null
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
},
"dependentOn": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
"dependentOn": "String",
"parentSettingId": "String"
}
],
"dependedOnBy": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
"dependedOnBy": "String",
"required": true
}
],
"itemId": "String",
"description": "String",
"helpText": "String",
"name": "String",
"displayName": "String"
}
],
"defaultOptionId": "String"
}