通过

更新 deviceManagementConfigurationPolicy

命名空间：microsoft.graph

重要：Microsoft支持Intune /beta API，但它们会受到更频繁的更改。 Microsoft建议尽可能使用版本 v1.0。 使用版本选择器检查 API 在 v1.0 版中的可用性。

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

更新 deviceManagementConfigurationPolicy 对象的属性。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

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

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
PATCH /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}

请求标头

标头 值
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
接受 application/json

请求正文

在请求正文中，提供 deviceManagementConfigurationPolicy 对象的 JSON 表示形式。

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

属性 类型 说明
id String 策略文档的键。 自动生成。
name String 策略名称
description String 策略说明
平台 deviceManagementConfigurationPlatforms 此策略的平台。 可能的值为：none、、iOSandroid、windows10unknownFutureValuelinuxmacOSwindows10XandroidEnterprise、aosp、visionOS、 。 tvOS
技术 deviceManagementConfigurationTechnologies 此策略的技术。 可能的值为：none、、windows10XManagementmdm、microsoftSenseappleRemoteManagementlinuxMdmextensibilityconfigManagerexchangeOnlinemobileApplicationManagement、、enrollmentendpointPrivilegeManagement、、、unknownFutureValue、、 。 androidwindowsOsRecovery
createdDateTime DateTimeOffset 策略创建日期和时间
lastModifiedDateTime DateTimeOffset 策略上次修改日期和时间
settingCount Int32 设置数
creationSource String 策略创建源
roleScopeTagIds 字符串集合 此实体实例的范围标记列表。
isAssigned 布尔值 策略分配状态。 此属性是只读的。
disableEntraGroupPolicyAssignment 布尔值 指示是否禁用 Entra 组策略分配
templateReference deviceManagementConfigurationPolicyTemplateReference 模板参考信息
priorityMetaData deviceManagementPriorityMetaData 指示管理员在注册过程中选择的每个策略的优先级

响应

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

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
Content-type: application/json
Content-length: 855

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
  "name": "Name value",
  "description": "Description value",
  "platforms": "android",
  "technologies": "mdm",
  "settingCount": 12,
  "creationSource": "Creation Source value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "isAssigned": true,
  "disableEntraGroupPolicyAssignment": true,
  "templateReference": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyTemplateReference",
    "templateId": "Template Id value",
    "templateFamily": "endpointSecurityAntivirus",
    "templateDisplayName": "Template Display Name value",
    "templateDisplayVersion": "Template Display Version value"
  },
  "priorityMetaData": {
    "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
    "priority": 8
  }
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
  "id": "3ffd7cd0-7cd0-3ffd-d07c-fd3fd07cfd3f",
  "name": "Name value",
  "description": "Description value",
  "platforms": "android",
  "technologies": "mdm",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "settingCount": 12,
  "creationSource": "Creation Source value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "isAssigned": true,
  "disableEntraGroupPolicyAssignment": true,
  "templateReference": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyTemplateReference",
    "templateId": "Template Id value",
    "templateFamily": "endpointSecurityAntivirus",
    "templateDisplayName": "Template Display Name value",
    "templateDisplayVersion": "Template Display Version value"
  },
  "priorityMetaData": {
    "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
    "priority": 8
  }
}
  • Last updated on