创建 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"
}
}
]
}