Creación de groupPolicySettingMapping

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Cree un nuevo objeto groupPolicySettingMapping .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

POST /deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto groupPolicySettingMapping.

En la tabla siguiente se muestran las propiedades necesarias al crear groupPolicySettingMapping.

Propiedad	Tipo	Descripción
id	Cadena
parentId	Cadena	Id. primario de la configuración de directiva de grupo.
childIdList	Colección string	Lista de identificadores secundarios de la configuración de directiva de grupo.
settingName	Cadena	Nombre de esta configuración de directiva de grupo.
settingValue	Cadena	Valor de esta configuración de directiva de grupo.
settingValueType	Cadena	Tipo de valor de esta configuración de directiva de grupo.
settingDisplayName	Cadena	Nombre para mostrar de esta configuración de directiva de grupo.
settingDisplayValue	Cadena	Valor para mostrar de esta configuración de directiva de grupo.
settingDisplayValueType	Cadena	Tipo de valor para mostrar de esta configuración de directiva de grupo.
settingValueDisplayUnits	Cadena	Unidades para mostrar de este valor de configuración de directiva de grupo
settingCategory	Cadena	Categoría en la que se encuentra la configuración de directiva de grupo.
mdmCspName	Cadena	El nombre de CSP al que se asigna esta configuración de directiva de grupo.
mdmSettingUri	Cadena	El URI de CSP de MDM al que se asigna esta configuración de directiva de grupo.
mdmMinimumOSVersion	Int32	La versión mínima del sistema operativo que admite esta configuración de MDM.
settingType	groupPolicySettingType	Tipo de configuración (seguridad o admx) del directiva de grupo. Los valores posibles son: unknown, policy, account, securityOptions, userRightsAssignment, windowsFirewallSettingsauditSetting, appLockerRuleCollection, , dataSourcesSettings, devicesSettings, driveMapSettings, environmentVariables, filesSettings, folderOptions, iniFilesinternetOptionslocalUsersAndGroupsfolders, networkOptions, networkShares, regionalOptionsSettingspowerOptionsntServicesprinters, registrySettings, , scheduledTasks, , . startMenuSettingsshortcutSettings
isMdmSupported	Booleano	Indica si la configuración es compatible con Intune o no
mdmSupportedState	mdmSupportedState	Indica si la configuración se admite en Mdm o no. Los valores posibles son: unknown, supported, unsupported y deprecated.
settingScope	groupPolicySettingScope	Ámbito de la configuración. Los valores posibles son: unknown, device y user.
intuneSettingUriList	Colección string	Lista de uri de configuración de Intune a los que se asigna esta configuración de directiva de grupo
intuneSettingDefinitionId	Cadena	Identificador de definición de configuración de Intune
admxSettingDefinitionId	Cadena	Admx directiva de grupo Id.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto groupPolicySettingMapping en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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"
}