创建 deviceManagementConfigurationPolicy

命名空间：microsoft.graph

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

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

创建新的 deviceManagementConfigurationPolicy 对象。

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

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

权限

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

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

HTTP 请求

POST /deviceManagement/configurationPolicies
POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	策略文档的键。 自动生成。
name	String	策略名称
description	String	策略说明
平台	deviceManagementConfigurationPlatforms	此策略的平台。 可取值为：none、android、iOS、macOS、windows10X、windows10、linux、unknownFutureValue、androidEnterprise、aosp。
技术	deviceManagementConfigurationTechnologies	此策略的技术。 可能的值为：、、mdm、、windows10XManagementextensibilitylinuxMdmmicrosoftSenseconfigManagerexchangeOnlinemobileApplicationManagementappleRemoteManagement、enrollment、endpointPrivilegeManagement、 。 androidunknownFutureValuewindowsOsRecoverynone
createdDateTime	DateTimeOffset	策略创建日期和时间
lastModifiedDateTime	DateTimeOffset	策略上次修改日期和时间
settingCount	Int32	设置数
creationSource	String	策略创建源
roleScopeTagIds	字符串集合	此实体实例的范围标记列表。
isAssigned	布尔值	策略分配状态。 此属性是只读的。
templateReference	deviceManagementConfigurationPolicyTemplateReference	模板参考信息
priorityMetaData	deviceManagementPriorityMetaData	指示管理员在注册过程中选择的每个策略的优先级

响应

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

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
Content-type: application/json
Content-length: 809

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
  "name": "Name value",
  "description": "Description value",
  "platforms": "android",
  "technologies": "mdm",
  "settingCount": 12,
  "creationSource": "Creation Source value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "isAssigned": true,
  "templateReference": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyTemplateReference",
    "templateId": "Template Id value",
    "templateFamily": "endpointSecurityAntivirus",
    "templateDisplayName": "Template Display Name value",
    "templateDisplayVersion": "Template Display Version value"
  },
  "priorityMetaData": {
    "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
    "priority": 8
  }
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
  "id": "3ffd7cd0-7cd0-3ffd-d07c-fd3fd07cfd3f",
  "name": "Name value",
  "description": "Description value",
  "platforms": "android",
  "technologies": "mdm",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "settingCount": 12,
  "creationSource": "Creation Source value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "isAssigned": true,
  "templateReference": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyTemplateReference",
    "templateId": "Template Id value",
    "templateFamily": "endpointSecurityAntivirus",
    "templateDisplayName": "Template Display Name value",
    "templateDisplayVersion": "Template Display Version value"
  },
  "priorityMetaData": {
    "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
    "priority": 8
  }
}