Compartir a través de

Creación de deviceManagementConfigurationSettingGroupDefinition

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

Cree un nuevo objeto deviceManagementConfigurationSettingGroupDefinition .

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

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

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

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 string Configuración secundaria dependiente de este grupo de configuraciones.
dependentOn colección deviceManagementConfigurationDependentOn Lista de dependencias del grupo de configuración
dependedOnBy Colección deviceManagementConfigurationSettingDependedOnBy Lista de configuraciones secundarias que dependen de esta configuración

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/deviceManagement/reusableSettings
Content-type: application/json
Content-length: 1731

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "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
    }
  ]
}

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "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": "95dc9604-9604-95dc-0496-dc950496dc95",
  "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
    }
  ]
}