更新 deviceComanagementAuthorityConfiguration

命名空间：microsoft.graph

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

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

更新 deviceComanagementAuthorityConfiguration 对象的 属性。

先决条件

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

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

HTTP 请求

PATCH /deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}

请求标头

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

请求正文

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

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

属性	类型	说明
id	字符串	从 deviceEnrollmentConfiguration 继承的帐户的唯一标识符
displayName	字符串	从 deviceEnrollmentConfiguration 继承的设备注册配置的显示名称
说明	字符串	从 deviceEnrollmentConfiguration 继承的设备注册配置的说明
priority	Int32	当用户存在于分配了注册配置的多个组中时，将使用优先级。 用户仅受优先级最低的配置的约束。 继承自 deviceEnrollmentConfiguration
createdDateTime	DateTimeOffset	在 UTC 中创建的设备注册配置的日期时间继承自 deviceEnrollmentConfiguration
lastModifiedDateTime	DateTimeOffset	从 deviceEnrollmentConfiguration 继承的设备注册配置的 UTC 中上次修改的日期时间
version	Int32	从 deviceEnrollmentConfiguration 继承的设备注册配置的版本
roleScopeTagIds	字符串集合	注册限制的可选角色范围标记。 继承自 deviceEnrollmentConfiguration
deviceEnrollmentConfigurationType	deviceEnrollmentConfigurationType	支持从 deviceEnrollmentConfiguration 继承的注册配置类型。 可能的值是：unknown、limit、platformRestrictions、windowsHelloForBusiness、defaultLimit、defaultPlatformRestrictions、defaultWindowsHelloForBusiness、defaultWindows10EnrollmentCompletionPageConfiguration、windows10EnrollmentCompletionPageConfiguration、deviceComanagementAuthorityConfiguration、singlePlatformRestriction、unknownFutureValue、enrollmentNotificationsConfiguration。
managedDeviceAuthority	Int32	CoManagement Authority 配置 ManagedDeviceAuthority
installConfigurationManagerAgent	Boolean	CoManagement Authority 配置 InstallConfigurationManagerAgent
configurationManagerAgentCommandLineArgument	字符串	CoManagement Authority 配置 ConfigurationManagerAgentCommandLineArgument

响应

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

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
Content-type: application/json
Content-length: 494

{
  "@odata.type": "#microsoft.graph.deviceComanagementAuthorityConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "priority": 8,
  "version": 7,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "deviceEnrollmentConfigurationType": "limit",
  "managedDeviceAuthority": 6,
  "installConfigurationManagerAgent": true,
  "configurationManagerAgentCommandLineArgument": "Configuration Manager Agent Command Line Argument value"
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.deviceComanagementAuthorityConfiguration",
  "id": "0ba0057f-057f-0ba0-7f05-a00b7f05a00b",
  "displayName": "Display Name value",
  "description": "Description value",
  "priority": 8,
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "version": 7,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "deviceEnrollmentConfigurationType": "limit",
  "managedDeviceAuthority": 6,
  "installConfigurationManagerAgent": true,
  "configurationManagerAgentCommandLineArgument": "Configuration Manager Agent Command Line Argument value"
}