Actualizar deviceManagementConfigurationSettingGroupCollectionDefinition

Artículo
10/14/2024

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 deviceManagementConfigurationSettingGroupCollectionDefinition .

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/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}

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 deviceManagementConfigurationSettingGroupCollectionDefinition .

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

Propiedad	Tipo	Descripción
aplicabilidad	deviceManagementConfigurationSettingApplicability	Detalles sobre qué configuración de dispositivo es aplicable. Admite: $filters. Heredado de deviceManagementConfigurationSettingDefinition
accessTypes	deviceManagementConfigurationSettingAccessTypes	Modo de acceso de lectura y escritura de la configuración Heredada de deviceManagementConfigurationSettingDefinition. Valores posibles: `none`, `add`, `copy`, `delete`, `get`, `replace`, `execute`.
keywords	Colección de cadenas	Tokens que se van a buscar en La configuración heredada de deviceManagementConfigurationSettingDefinition
infoUrls	Colección string	Puede encontrar una lista de vínculos con más información sobre la configuración en . Heredado de deviceManagementConfigurationSettingDefinition
ocurrencia	deviceManagementConfigurationSettingOccurrence	Indica si la configuración es necesaria o no heredada de deviceManagementConfigurationSettingDefinition
baseUri	Cadena	Ruta de acceso de CSP base heredada de deviceManagementConfigurationSettingDefinition
offsetUri	Cadena	Desplazamiento de la ruta de CSP de base heredada de deviceManagementConfigurationSettingDefinition
rootDefinitionId	Cadena	Id. de definición de configuración raíz si la configuración es una configuración secundaria. Heredado de deviceManagementConfigurationSettingDefinition
categoryId	Cadena	Especifique la categoría en la que se encuentra la configuración. $filters de soporte técnico. Heredado de deviceManagementConfigurationSettingDefinition
settingUsage	deviceManagementConfigurationSettingUsage	Indique el tipo de configuración para la configuración. Los valores posibles son: configuración, cumplimiento, reutilizableConfiguración. Cada uso de configuración tiene un punto final de API independiente al que llamar. Se hereda de deviceManagementConfigurationSettingDefinition. Los valores posibles son: `none`, `configuration`, `compliance`, `unknownFutureValue` y `inventory`.
uxBehavior	deviceManagementConfigurationControlType	Establecer la representación del tipo de control en la experiencia de usuario. Los valores posibles son: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Se hereda de deviceManagementConfigurationSettingDefinition. Los valores posibles son: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane` y `unknownFutureValue`.
visibility	deviceManagementConfigurationSettingVisibility	Establecer el ámbito de visibilidad en la experiencia de usuario. Los valores posibles son: none, settingsCatalog, template. Se hereda de deviceManagementConfigurationSettingDefinition. Los valores posibles son: `none`, `settingsCatalog`, `template`, `unknownFutureValue` y `inventoryCatalog`.
referredSettingInformationList	colección deviceManagementConfigurationReferredSettingInformation	Lista de información de configuración referenciada. Heredado de deviceManagementConfigurationSettingDefinition
id	Cadena	Identificador del elemento heredado de deviceManagementConfigurationSettingDefinition
description	Cadena	Descripción de la configuración. Heredado de deviceManagementConfigurationSettingDefinition
helpText	Cadena	Texto de ayuda de la configuración. Proporcione más detalles de la configuración. Heredado de deviceManagementConfigurationSettingDefinition
name	Cadena	Nombre del elemento Heredado de deviceManagementConfigurationSettingDefinition
displayName	String	Nombre de la configuración. Por ejemplo: Permitir notificación del sistema. Heredado de deviceManagementConfigurationSettingDefinition
version	Cadena	Versión del elemento heredada de deviceManagementConfigurationSettingDefinition
childIds	Colección de cadenas	Configuración secundaria dependiente de este grupo de configuraciones. Heredado de deviceManagementConfigurationSettingGroupDefinition
dependentOn	colección deviceManagementConfigurationDependentOn	Lista de dependencias del grupo de configuración Heredado de deviceManagementConfigurationSettingGroupDefinition
dependedOnBy	Colección deviceManagementConfigurationSettingDependedOnBy	Lista de configuraciones secundarias que dependen de esta configuración heredada de deviceManagementConfigurationSettingGroupDefinition
maximumCount	Int32	Número máximo de recuento de grupos de configuración en la colección. Valores válidos de 1 a 100
minimumCount	Int32	Número mínimo de recuento de grupos de configuración en la colección. Valores válidos de 1 a 100

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
Content-type: application/json
Content-length: 1787

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ],
  "maximumCount": 12,
  "minimumCount": 12
}

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: 1836

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "739da194-a194-739d-94a1-9d7394a19d73",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ],
  "maximumCount": 12,
  "minimumCount": 12
}

Compartir a través de

Actualizar deviceManagementConfigurationSettingGroupCollectionDefinition

Permisos

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplo

Solicitud

Respuesta

Comentarios

Recursos adicionales