更新 groupPolicySettingMapping

命名空间：microsoft.graph

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

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

更新 groupPolicySettingMapping 对象 的属性。

先决条件

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

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

HTTP 请求

PATCH /deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings/{groupPolicySettingMappingId}

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	尚未记录
parentId	String	组策略设置的父 ID。
childIdList	字符串集合	组策略设置的子 ID 列表。
settingName	String	此组策略设置的名称。
settingValue	String	此组策略设置的值。
settingValueType	String	此组策略设置的值类型。
settingDisplayName	String	此显示名称策略设置的成员。
settingDisplayValue	String	此组策略设置的显示值。
settingDisplayValueType	String	此组策略设置的显示值类型。
settingValueDisplayUnits	String	此组策略设置值的显示单位
settingCategory	String	组策略设置位于的类别。
mdmCspName	String	此组策略设置映射到的云解决方案提供商名称。
mdmSettingUri	String	此组策略设置映射到的 MDM CSP URI。
mdmMinimumOSVersion	Int32	此 mdm 设置支持的最低操作系统版本。
settingType	groupPolicySettingType	设置类型 (策略的安全性) admx。 可能的值是 unknown policy account ：、、、、、、、、 securityOptions userRightsAssignment auditSetting windowsFirewallSettings appLockerRuleCollection dataSourcesSettings devicesSettings driveMapSettings environmentVariables filesSettings folderOptions folders iniFiles internetOptions localUsersAndGroups networkOptions networkShares ntServices powerOptions printers regionalOptionsSettings registrySettings scheduledTasks shortcutSettings startMenuSettings 。
isMdmSupported	布尔值	指示 Intune 是否支持该设置
mdmSupportedState	mdmSupportedState	指示设置在 Mdm 中是否受支持。 可能的值是：unknown、supported、unsupported、deprecated。
settingScope	groupPolicySettingScope	设置的范围。 可取值为：unknown、device、user。
intuneSettingUriList	字符串集合	此组策略设置映射到的 Intune 设置 URI 列表
intuneSettingDefinitionId	String	Intune 设置定义 ID
admxSettingDefinitionId	String	Admx 组策略 ID

响应

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

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings/{groupPolicySettingMappingId}
Content-type: application/json
Content-length: 1023

{
  "@odata.type": "#microsoft.graph.groupPolicySettingMapping",
  "parentId": "Parent Id value",
  "childIdList": [
    "Child Id List value"
  ],
  "settingName": "Setting Name value",
  "settingValue": "Setting Value value",
  "settingValueType": "Setting Value Type value",
  "settingDisplayName": "Setting Display Name value",
  "settingDisplayValue": "Setting Display Value value",
  "settingDisplayValueType": "Setting Display Value Type value",
  "settingValueDisplayUnits": "Setting Value Display Units value",
  "settingCategory": "Setting Category value",
  "mdmCspName": "Mdm Csp Name value",
  "mdmSettingUri": "Mdm Setting Uri value",
  "mdmMinimumOSVersion": 3,
  "settingType": "policy",
  "isMdmSupported": true,
  "mdmSupportedState": "supported",
  "settingScope": "device",
  "intuneSettingUriList": [
    "Intune Setting Uri List value"
  ],
  "intuneSettingDefinitionId": "Intune Setting Definition Id value",
  "admxSettingDefinitionId": "Admx Setting Definition Id value"
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.groupPolicySettingMapping",
  "id": "8fa04560-4560-8fa0-6045-a08f6045a08f",
  "parentId": "Parent Id value",
  "childIdList": [
    "Child Id List value"
  ],
  "settingName": "Setting Name value",
  "settingValue": "Setting Value value",
  "settingValueType": "Setting Value Type value",
  "settingDisplayName": "Setting Display Name value",
  "settingDisplayValue": "Setting Display Value value",
  "settingDisplayValueType": "Setting Display Value Type value",
  "settingValueDisplayUnits": "Setting Value Display Units value",
  "settingCategory": "Setting Category value",
  "mdmCspName": "Mdm Csp Name value",
  "mdmSettingUri": "Mdm Setting Uri value",
  "mdmMinimumOSVersion": 3,
  "settingType": "policy",
  "isMdmSupported": true,
  "mdmSupportedState": "supported",
  "settingScope": "device",
  "intuneSettingUriList": [
    "Intune Setting Uri List value"
  ],
  "intuneSettingDefinitionId": "Intune Setting Definition Id value",
  "admxSettingDefinitionId": "Admx Setting Definition Id value"
}