Обновление deviceManagementConfigurationSettingGroupDefinition

Статья
09/12/2024

Пространство имен: microsoft.graph

Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновите свойства объекта deviceManagementConfigurationSettingGroupDefinition .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тексте запроса укажите представление объекта deviceManagementConfigurationSettingGroupDefinition в формате JSON.

В следующей таблице показаны свойства, необходимые при создании deviceManagementConfigurationSettingGroupDefinition.

Свойство	Тип	Описание
применимость	deviceManagementConfigurationSettingApplicability	Сведения о том, к какому параметру устройства относится. Поддерживает: $filters. Наследуется от deviceManagementConfigurationSettingDefinition
accessTypes	deviceManagementConfigurationSettingAccessTypes	Режим доступа на чтение и запись параметра Наследуется от deviceManagementConfigurationSettingDefinition. Возможные значения: `none`, `add`, `copy`, `delete`, `get`, `replace`, `execute`.
keywords	Коллекция строк	Маркеры для поиска параметров в наследуется от deviceManagementConfigurationSettingDefinition
infoUrls	Коллекция строк	Список ссылок, дополнительные сведения о параметре можно найти по адресу. Наследуется от deviceManagementConfigurationSettingDefinition
происшествие	deviceManagementConfigurationSettingOccurrence	Указывает, является ли параметр обязательным или не наследуется от deviceManagementConfigurationSettingDefinition.
baseUri	String	Базовый путь CSP, унаследованный от deviceManagementConfigurationSettingDefinition
offsetUri	String	Смещение пути CSP от базового унаследованного от deviceManagementConfigurationSettingDefinition
rootDefinitionId	String	Идентификатор определения корневого параметра, если параметр является дочерним параметром. Наследуется от deviceManagementConfigurationSettingDefinition
categoryId	String	Укажите категорию, в которой находится параметр. Поддержка $filters. Наследуется от deviceManagementConfigurationSettingDefinition
settingUsage	deviceManagementConfigurationSettingUsage	Укажите тип параметра. Возможные значения: конфигурация, соответствие, reusableSetting. Каждое использование параметра имеет отдельную конечную точку API для вызова. Наследуется от deviceManagementConfigurationSettingDefinition. Возможные значения: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.
uxBehavior	deviceManagementConfigurationControlType	Задание представления типа элемента управления в пользовательском интерфейсе. Возможные значения: default, раскрывающийся список, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Наследуется от deviceManagementConfigurationSettingDefinition. Возможные значения: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.
visibility	deviceManagementConfigurationSettingVisibility	Настройка область видимости для пользовательского интерфейса. Возможные значения: none, settingsCatalog, template. Наследуется от deviceManagementConfigurationSettingDefinition. Возможные значения: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.
referredSettingInformationList	коллекция deviceManagementConfigurationReferredSettingInformation	Список сведений о параметрах, на которые ссылается ссылка. Наследуется от deviceManagementConfigurationSettingDefinition
id	String	Идентификатор элемента, наследуемого от deviceManagementConfigurationSettingDefinition
description	String	Описание параметра. Наследуется от deviceManagementConfigurationSettingDefinition
helpText	String	Текст справки по параметру. Укажите дополнительные сведения о параметре. Наследуется от deviceManagementConfigurationSettingDefinition
name	String	Имя элемента, наследуемое от deviceManagementConfigurationSettingDefinition
displayName	String	Имя параметра. Например: Разрешить всплывающее уведомление. Наследуется от deviceManagementConfigurationSettingDefinition
version	String	Версия элемента, наследуемая от deviceManagementConfigurationSettingDefinition
childIds	Коллекция строк	Зависимые дочерние параметры для этой группы параметров.
dependentOn	коллекция deviceManagementConfigurationDependentOn	Список зависимостей для группы параметров
dependedOnBy	коллекция deviceManagementConfigurationSettingDependedOnBy	Список дочерних параметров, зависящих от этого параметра

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код ответа и обновленный объект deviceManagementConfigurationSettingGroupDefinition в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

PATCH https://graph.microsoft.com/beta/deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
Content-type: application/json
Content-length: 1731

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1780

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "95dc9604-9604-95dc-0496-dc950496dc95",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}

Поделиться через

Обновление deviceManagementConfigurationSettingGroupDefinition

Разрешения

HTTP-запрос

Заголовки запроса

Текст запроса

Отклик

Пример

Запрос

Отклик

Обратная связь

Дополнительные ресурсы