创建 securityBaselineCategoryStateSummary

命名空间：microsoft.graph

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

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

创建新的 securityBaselineCategoryStateSummary 对象。

此 API 可用于以下国家级云部署。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

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

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

HTTP 请求

POST /deviceManagement/templates/{deviceManagementTemplateId}/microsoft.graph.securityBaselineTemplate/categoryDeviceStateSummaries

请求标头

标头	值
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。
接受	application/json

请求正文

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

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

属性	类型	说明
id	String	实体的唯一标识符。 继承自 securityBaselineStateSummary
secureCount	Int32	从 securityBaselineStateSummary 继承的安全设备数
notSecureCount	Int32	从 securityBaselineStateSummary 继承的不安全设备数
unknownCount	Int32	从 securityBaselineStateSummary 继承的未知设备数
errorCount	Int32	从 securityBaselineStateSummary 继承的错误设备数
conflictCount	Int32	从 securityBaselineStateSummary 继承的冲突设备数
notApplicableCount	Int32	从 securityBaselineStateSummary 继承的不适用设备数
displayName	String	类别名称

响应

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

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/beta/deviceManagement/templates/{deviceManagementTemplateId}/microsoft.graph.securityBaselineTemplate/categoryDeviceStateSummaries
Content-type: application/json
Content-length: 261

{
  "@odata.type": "#microsoft.graph.securityBaselineCategoryStateSummary",
  "secureCount": 11,
  "notSecureCount": 14,
  "unknownCount": 12,
  "errorCount": 10,
  "conflictCount": 13,
  "notApplicableCount": 2,
  "displayName": "Display Name value"
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.securityBaselineCategoryStateSummary",
  "id": "7a650997-0997-7a65-9709-657a9709657a",
  "secureCount": 11,
  "notSecureCount": 14,
  "unknownCount": 12,
  "errorCount": 10,
  "conflictCount": 13,
  "notApplicableCount": 2,
  "displayName": "Display Name value"
}