Создание groupPolicySettingMapping
Пространство имен: microsoft.graph
Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Создайте объект groupPolicySettingMapping .
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | DeviceManagementConfiguration.ReadWrite.All |
HTTP-запрос
POST /deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Текст запроса
В тексте запроса укажите представление объекта groupPolicySettingMapping в формате JSON.
В следующей таблице показаны свойства, необходимые при создании groupPolicySettingMapping.
Свойство | Тип | Описание |
---|---|---|
id | String | |
parentId | String | Родительский идентификатор параметра групповой политики. |
childIdList | Коллекция строк | Список дочерних идентификаторов параметра групповой политики. |
settingName | String | Имя этого параметра групповой политики. |
settingValue | String | Значение этого параметра групповой политики. |
settingValueType | String | Тип значения этого параметра групповой политики. |
settingDisplayName | String | Отображаемое имя этого параметра групповой политики. |
settingDisplayValue | String | Отображаемое значение этого параметра групповой политики. |
settingDisplayValueType | String | Тип отображаемого значения этого параметра групповой политики. |
settingValueDisplayUnits | String | Единицы отображения значения параметра групповой политики |
settingCategory | String | Категория, в рамках параметра групповой политики. |
mdmCspName | String | CSP называет этот параметр групповой политики. |
mdmSettingUri | String | URI CSP MDM, с который сопоставляется этот параметр групповой политики. |
mdmMinimumOSVersion | Int32 | Минимальная версия ОС, поддерживается этим параметром mdm. |
settingType | groupPolicySettingType | Тип параметра (безопасность или admx) групповой политики. Возможные значения: unknown , , account policy , , userRightsAssignment securityOptions , auditSetting , windowsFirewallSettings , appLockerRuleCollection dataSourcesSettings , filesSettings internetOptions iniFiles folders localUsersAndGroups environmentVariables networkOptions folderOptions networkShares driveMapSettings ntServices devicesSettings , powerOptions , printers , , . startMenuSettings regionalOptionsSettings registrySettings scheduledTasks shortcutSettings |
isMdmSupported | Логический | Указывает, поддерживается ли параметр Intune или нет. |
mdmSupportedState | mdmSupportedState | Указывает, поддерживается ли параметр в Mdm или нет. Возможные значения: unknown , supported , unsupported , deprecated . |
settingScope | groupPolicySettingScope | Область действия параметра. Возможные значения: unknown , device , user . |
intuneSettingUriList | Коллекция строк | Список URI параметров Intune, с с помощью параметра групповой политики |
intuneSettingDefinitionId | String | Идентификатор определения параметра Intune |
admxSettingDefinitionId | String | Идентификатор групповой политики Admx |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created
и объект groupPolicySettingMapping в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings
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 201 Created
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"
}