Actualizar groupPolicySettingMapping

  • Artículo

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.

Actualice las propiedades de un 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

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

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) de la 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 Intune admite o no la configuración.
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 de cadenas La 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 Identificador de directiva de grupo de Admx

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

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