更新 deviceManagementConfigurationSettingGroupCollectionDefinition

命名空间:microsoft.graph

重要: /beta 版本下的 Microsoft Graph API 可能会发生更改;不支持生产用途。

注意: 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证

更新 deviceManagementConfigurationSettingGroupCollectionDefinition 对象的 属性。

先决条件

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) DeviceManagementConfiguration.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
Application DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

PATCH /deviceManagement/reusableSettings/{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}

请求标头

标头
Authorization Bearer <token>。必需。
接受 application/json

请求正文

在请求正文中,为 deviceManagementConfigurationSettingGroupCollectionDefinition 对象提供 JSON 表示形式。

下表显示了创建 deviceManagementConfigurationSettingGroupCollectionDefinition 时所需的属性。

属性 类型 Description
适用性 deviceManagementConfigurationSettingApplicability 详细信息:从 deviceManagementConfigurationSettingDefinition 继承的设备设置适用
accessTypes deviceManagementConfigurationSettingAccessTypes deviceManagementConfigurationSettingDefinition 继承的设置的读/写访问模式。 可取值为:noneaddcopydeletegetreplaceexecute
keywords 字符串集合 要在从 deviceManagementConfigurationSettingDefinition 上搜索设置的令牌
infoUrls String 集合 可在从 deviceManagementConfigurationSettingDefinition 继承处找到有关设置的链接的详细信息列表
发生 deviceManagementConfigurationSettingOccurrence 指示是否需要设置从 deviceManagementConfigurationSettingDefinition 继承
baseUri String deviceManagementConfigurationSettingDefinition 继承的基本 CSP 路径
offsetUri 字符串 deviceManagementConfigurationSettingDefinition 继承的基础的偏移 CSP 路径
rootDefinitionId String 根设置定义(如果设置是子设置)。 继承自 deviceManagementConfigurationSettingDefinition
categoryId 字符串 指定在指定的配置服务提供程序中配置设置的区域组 (CSP) 从 deviceManagementConfigurationSettingDefinition 继承
settingUsage deviceManagementConfigurationSettingUsage 设置类型,例如,从 deviceManagementConfigurationSettingDefinition 继承的配置和符合性。 可取值为:noneconfigurationcompliance
uxBehavior deviceManagementConfigurationControlType 在从 deviceManagementConfigurationSettingDefinition 继承的 UX 中设置控件类型表示形式。 可取值为:defaultdropdownsmallTextBoxlargeTextBoxtogglemultiheaderGridcontextPane
visibility deviceManagementConfigurationSettingVisibility 将可见性范围设置为从 deviceManagementConfigurationSettingDefinition 继承的 UX。 可取值为:nonesettingsCatalogtemplate
referredSettingInformationList deviceManagementConfigurationReferredSettingInformation 集合 引用的设置信息列表。 继承自 deviceManagementConfigurationSettingDefinition
id 字符串 deviceManagementConfigurationSettingDefinition 继承的项的标识符
说明 字符串 deviceManagementConfigurationSettingDefinition 继承的项目说明
helpText 字符串 deviceManagementConfigurationSettingDefinition 继承的项目帮助文本
name 字符串 deviceManagementConfigurationSettingDefinition 继承的项目名称
displayName String deviceManagementConfigurationSettingDefinition 继承的项的显示名称
version String deviceManagementConfigurationSettingDefinition 继承的项目版本
childIds 字符串集合 deviceManagementConfigurationSettingGroupDefinition 继承的这组设置的从属子设置
dependentOn deviceManagementConfigurationDependentOn 集合 deviceManagementConfigurationSettingGroupDefinition 继承的设置组的依赖项列表
dependedOnBy deviceManagementConfigurationSettingDependedOnBy 集合 依赖于此设置的子设置列表继承自 deviceManagementConfigurationSettingGroupDefinition
maximumCount Int32 集合中设置组计数的最大数目。 有效值 1 到 100
minimumCount Int32 集合中设置组计数的最小数目。 有效值 1 到 100

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新的 deviceManagementConfigurationSettingGroupCollectionDefinition 对象。

示例

请求

下面是一个请求示例。

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
  "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
    }
  ],
  "maximumCount": 12,
  "minimumCount": 12
}

响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
  "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": "739da194-a194-739d-94a1-9d7394a19d73",
  "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
    }
  ],
  "maximumCount": 12,
  "minimumCount": 12
}