更新 deviceManagement

项目
09/13/2021

命名空间：microsoft.graph

重要提示： Microsoft Graph /beta 版本的 API 可能会更改。不支持在生产应用程序中使用这些 API。

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

更新 deviceManagement 对象的属性。

先决条件

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

请注意，权限因工作流而异。

工作流 (的权限类型)	权限（从最高特权到最低特权）
委派（工作或学校帐户）
Android for Work	DeviceManagementConfiguration.ReadWrite.All
审核	DeviceManagementApps.ReadWrite.All
公司条款	DeviceManagementServiceConfig.ReadWrite.All
设备配置	DeviceManagementConfiguration.ReadWrite.All
设备意图	DeviceManagementConfiguration.ReadWrite.All
设备管理	DeviceManagementManagedDevices.ReadWrite.All
电子 SIM 卡	DeviceManagementConfiguration.ReadWrite.All
注册	DeviceManagementServiceConfig.ReadWrite.All
Fencing	DeviceManagementConfiguration.ReadWrite.All
通知	DeviceManagementServiceConfig.ReadWrite.All
Odj	DeviceManagementServiceConfig.ReadWrite.All
载入	DeviceManagementServiceConfig.ReadWrite.All
策略集	DeviceManagementServiceConfig.ReadWrite.All
基于角色的访问控制 (RBAC)	DeviceManagementRBAC.ReadWrite.All
远程访问	DeviceManagementConfiguration.Read.All
远程协助	DeviceManagementServiceConfig.ReadWrite.All
软件更新	DeviceManagementServiceConfig.ReadWrite.All
电信费用管理	DeviceManagementServiceConfig.ReadWrite.All
问题	DeviceManagementManagedDevices.ReadWrite.All
Windows 信息保护	DeviceManagementApps.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序
Android for Work	DeviceManagementConfiguration.ReadWrite.All
审核	DeviceManagementApps.ReadWrite.All
公司条款	DeviceManagementServiceConfig.ReadWrite.All
设备配置	DeviceManagementConfiguration.ReadWrite.All
设备意图	DeviceManagementConfiguration.ReadWrite.All
设备管理	DeviceManagementManagedDevices.ReadWrite.All
电子 SIM 卡	DeviceManagementConfiguration.ReadWrite.All
注册	DeviceManagementServiceConfig.ReadWrite.All
Fencing	DeviceManagementConfiguration.ReadWrite.All
通知	DeviceManagementServiceConfig.ReadWrite.All
Odj	DeviceManagementServiceConfig.ReadWrite.All
载入	DeviceManagementServiceConfig.ReadWrite.All
策略集	DeviceManagementServiceConfig.ReadWrite.All
基于角色的访问控制 (RBAC)	DeviceManagementRBAC.ReadWrite.All
远程访问	DeviceManagementConfiguration.Read.All
远程协助	DeviceManagementServiceConfig.ReadWrite.All
软件更新	DeviceManagementServiceConfig.ReadWrite.All
电信费用管理	DeviceManagementServiceConfig.ReadWrite.All
问题	DeviceManagementManagedDevices.ReadWrite.All
Windows 信息保护	DeviceManagementApps.ReadWrite.All

HTTP 请求

PATCH /deviceManagement

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	设备的唯一标识符。
设备配置
intuneAccountId	GUID	给定租户的 Intune 帐户 ID
legacyPcManangementEnabled	Boolean	用于为此帐户启用非 MDM 托管旧版电脑管理的属性。此属性是只读的。
maximumDepTokens	Int32	允许每个租户使用的最大 DEP 令牌数。
settings	deviceManagementSettings	帐户级别设置。
设备管理
accountMoveCompletionDateTime	DateTimeOffset	租户&之间移动时的日期。
adminConsent	adminConsent	管理员同意信息。
deviceProtectionOverview	deviceProtectionOverview	设备保护概述。
managedDeviceCleanupSettings	managedDeviceCleanupSettings	设备清理规则
subscriptionState	deviceManagementSubscriptionState	租户移动设备管理订阅状态。可取值为：`pending`、`active`、`warning`、`disabled`、`deleted`、`blocked`、`lockedOut`。
订阅	deviceManagementSubscriptions	租户的订阅。可取值为：`none`、`intune`、`office365`、`intunePremium`、`intune_EDU`、`intune_SMB`。
windowsMalwareOverview	windowsMalwareOverview	Windows 设备的恶意软件概述。
载入
intuneBrand	intuneBrand	intuneBrand 包含在自定义公司门户应用程序以及最终用户 Web 门户的外观时使用的数据。

请求正文属性支持因工作流而异。

响应

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

示例

请求

下面是设备管理工作流之后的请求示例：

PATCH https://graph.microsoft.com/beta/deviceManagement
Content-type: application/json
Content-length: 751

{
  "subscriptionState": "active",
  "subscriptions": "intune",
  "adminConsent": {
    "@odata.type": "microsoft.graph.adminConsent",
    "shareAPNSData": "granted"
  },
  "deviceProtectionOverview": {
    "@odata.type": "microsoft.graph.deviceProtectionOverview",
    "totalReportedDeviceCount": 8,
    "inactiveThreatAgentDeviceCount": 14,
    "unknownStateThreatAgentDeviceCount": 2,
    "pendingSignatureUpdateDeviceCount": 1,
    "cleanDeviceCount": 0,
    "pendingFullScanDeviceCount": 10,
    "pendingRestartDeviceCount": 9,
    "pendingManualStepsDeviceCount": 13,
    "pendingOfflineScanDeviceCount": 13,
    "criticalFailuresDeviceCount": 11
  },
  "accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
}

响应

下面是一个响应示例。

注意：为简洁起见，可能会截断此处显示的响应对象。返回的属性因工作流和上下文而异。

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

{
  "@odata.type": "#microsoft.graph.deviceManagement",
  "id": "0b283420-3420-0b28-2034-280b2034280b",
  "subscriptionState": "active",
  "subscriptions": "intune",
  "adminConsent": {
    "@odata.type": "microsoft.graph.adminConsent",
    "shareAPNSData": "granted"
  },
  "deviceProtectionOverview": {
    "@odata.type": "microsoft.graph.deviceProtectionOverview",
    "totalReportedDeviceCount": 8,
    "inactiveThreatAgentDeviceCount": 14,
    "unknownStateThreatAgentDeviceCount": 2,
    "pendingSignatureUpdateDeviceCount": 1,
    "cleanDeviceCount": 0,
    "pendingFullScanDeviceCount": 10,
    "pendingRestartDeviceCount": 9,
    "pendingManualStepsDeviceCount": 13,
    "pendingOfflineScanDeviceCount": 13,
    "criticalFailuresDeviceCount": 11
  },
  "accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
}

更新 deviceManagement

先决条件

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

反馈