Compartir a través de

Creación de deviceManagementConfigurationSettingDefinition

Espacio de nombres: microsoft.graph

Importante: Microsoft admite Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.

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

Cree un nuevo objeto deviceManagementConfigurationSettingDefinition .

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

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

Propiedad Tipo Description
aplicabilidad deviceManagementConfigurationSettingApplicability Detalles sobre qué configuración de dispositivo es aplicable. Admite: $filters.
accessTypes deviceManagementConfigurationSettingAccessTypes Modo de acceso de lectura y escritura de la configuración. Valores posibles: none, add, copy, delete, get, replace, execute.
keywords Colección string Tokens en los que se va a buscar la configuración
infoUrls Colección string Puede encontrar una lista de vínculos con más información sobre la configuración en .
repetición deviceManagementConfigurationSettingOccurrence Indica si la configuración es obligatoria o no.
baseUri Cadena Ruta de acceso de CSP base
offsetUri Cadena Desplazamiento de la ruta de acceso de CSP desde la base
rootDefinitionId Cadena Id. de definición de configuración raíz si la configuración es una configuración secundaria.
categoryId Cadena Especifique la categoría en la que se encuentra la configuración. $filters de soporte técnico.
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. Los valores posibles son: none, configuration, compliance, unknownFutureValue, inventory, audit.
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. 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. Los valores posibles son: none, settingsCatalog, template, unknownFutureValue y inventoryCatalog.
riskLevel deviceManagementConfigurationSettingRiskLevel Establecer risklevel. Los valores posibles son: bajo, medio, alto. Los valores posibles son: low, medium y high.
referredSettingInformationList colección deviceManagementConfigurationReferredSettingInformation Lista de información de configuración referenciada.
id Cadena Identificador del elemento
description Cadena Descripción de la configuración.
helpText Cadena Texto de ayuda de la configuración. Proporcione más detalles de la configuración.
name Cadena Nombre del elemento
displayName String Nombre de la configuración. Por ejemplo: Permitir notificación del sistema.
version Cadena Versión del elemento

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto deviceManagementConfigurationSettingDefinition 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: 1286

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

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingDefinition",
  "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",
  "riskLevel": "medium",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "7af649e5-49e5-7af6-e549-f67ae549f67a",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value"
}
  • Last updated on