创建 deviceEnrollmentLimitConfiguration

  • 项目

命名空间：microsoft.graph

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

创建新的 deviceEnrollmentLimitConfiguration 对象。

权限

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

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

HTTP 请求

POST /deviceManagement/deviceEnrollmentConfigurations

请求标头

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

请求正文

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

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

属性 类型 说明
id String 继承自 deviceEnrollmentConfiguration 的帐户的唯一标识符
displayName String 继承自 deviceEnrollmentConfiguration 的设备注册配置的显示名称
说明 String 继承自 deviceEnrollmentConfiguration 的设备注册配置的说明
priority Int32 当用户存在于分配的注册配置的多个组中时，将使用优先级。 用户仅受具有最低优先级值的配置的约束。 继承自 deviceEnrollmentConfiguration
createdDateTime DateTimeOffset 从 deviceEnrollmentConfiguration 继承的设备注册配置的 UTC 创建日期时间
lastModifiedDateTime DateTimeOffset 设备注册配置的上次修改日期时间（UTC）继承自 deviceEnrollmentConfiguration
version Int32 继承自 deviceEnrollmentConfiguration 的设备注册配置版本
limit Int32 用户可以注册的最大设备数

响应

如果成功，此方法在响应正文中返回 201 Created 响应代码和 deviceEnrollmentLimitConfiguration 对象。

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceEnrollmentConfigurations
Content-type: application/json
Content-length: 205

{
  "@odata.type": "#microsoft.graph.deviceEnrollmentLimitConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "priority": 8,
  "version": 7,
  "limit": 5
}

响应

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

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 377

{
  "@odata.type": "#microsoft.graph.deviceEnrollmentLimitConfiguration",
  "id": "4f8c4e4c-4e4c-4f8c-4c4e-8c4f4c4e8c4f",
  "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,
  "limit": 5
}