创建 deviceManagementPartner

命名空间：microsoft.graph

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

创建新的 deviceManagementPartner 对象。

权限

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

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

HTTP 请求

POST /deviceManagement/deviceManagementPartners

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	实体的 ID
lastHeartbeatDateTime	DateTimeOffset	管理员启用“连接到设备管理合作伙伴”选项后上次检测信号的时间戳
partnerState	deviceManagementPartnerTenantState	此租户的合作伙伴状态。 可取值为：unknown、unavailable、enabled、terminated、rejected、unresponsive。
partnerAppType	deviceManagementPartnerAppType	合作伙伴应用类型。 可取值为：unknown、singleTenantApp、multiTenantApp。
singleTenantAppId	String	合作伙伴单个租户应用 ID
displayName	String	合作伙伴显示名称
isConfigured	Boolean	是否配置了设备管理合作伙伴
whenPartnerDevicesWillBeRemovedDateTime	DateTimeOffset	要删除 PartnerDevices 时的日期/时间（UTC 时间）
whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime	DateTimeOffset	PartnerDevices 将被标记为“不符合”时的日期/时间（UTC 时间）
groupsRequiringPartnerEnrollment	deviceManagementPartnerAssignment 集合	指定是否通过合作伙伴进行注册的用户组。

响应

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

示例

请求

下面是一个请求示例。

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

{
  "@odata.type": "#microsoft.graph.deviceManagementPartner",
  "lastHeartbeatDateTime": "2016-12-31T23:59:37.9174975-08:00",
  "partnerState": "unavailable",
  "partnerAppType": "singleTenantApp",
  "singleTenantAppId": "Single Tenant App Id value",
  "displayName": "Display Name value",
  "isConfigured": true,
  "whenPartnerDevicesWillBeRemovedDateTime": "2016-12-31T23:56:38.2655023-08:00",
  "whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime": "2016-12-31T23:58:42.2131231-08:00",
  "groupsRequiringPartnerEnrollment": [
    {
      "@odata.type": "microsoft.graph.deviceManagementPartnerAssignment",
      "target": {
        "@odata.type": "microsoft.graph.configurationManagerCollectionAssignmentTarget",
        "collectionId": "Collection Id value"
      }
    }
  ]
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.deviceManagementPartner",
  "id": "d21e377a-377a-d21e-7a37-1ed27a371ed2",
  "lastHeartbeatDateTime": "2016-12-31T23:59:37.9174975-08:00",
  "partnerState": "unavailable",
  "partnerAppType": "singleTenantApp",
  "singleTenantAppId": "Single Tenant App Id value",
  "displayName": "Display Name value",
  "isConfigured": true,
  "whenPartnerDevicesWillBeRemovedDateTime": "2016-12-31T23:56:38.2655023-08:00",
  "whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime": "2016-12-31T23:58:42.2131231-08:00",
  "groupsRequiringPartnerEnrollment": [
    {
      "@odata.type": "microsoft.graph.deviceManagementPartnerAssignment",
      "target": {
        "@odata.type": "microsoft.graph.configurationManagerCollectionAssignmentTarget",
        "collectionId": "Collection Id value"
      }
    }
  ]
}