Compartir a través de

Creación de deviceManagementComplexSettingDefinition

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

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/settingDefinitions
POST /deviceManagement/categories/{deviceManagementSettingCategoryId}/settingDefinitions
POST /deviceManagement/intents/{deviceManagementIntentId}/categories/{deviceManagementIntentSettingCategoryId}/settingDefinitions
POST /deviceManagement/templates/{deviceManagementTemplateId}/categories/{deviceManagementTemplateSettingCategoryId}/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 deviceManagementComplexSettingDefinition.

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

Propiedad Tipo Descripción
id Cadena Identificador de la definición de configuración heredada de deviceManagementSettingDefinition
valueType deviceManangementIntentValueType Tipo de datos del valor Heredado de deviceManagementSettingDefinition. Los valores posibles son: integer, boolean, string, complex, collection, abstractComplex.
displayName Cadena Nombre para mostrar de la configuración Heredado de deviceManagementSettingDefinition
isTopLevel Booleano Si la configuración es de nivel superior, se puede configurar sin necesidad de encapsularse en una colección o una configuración compleja Heredada de deviceManagementSettingDefinition
description Cadena Descripción de la configuración Heredada de deviceManagementSettingDefinition
placeholderText Cadena Texto de marcador de posición como ejemplo de entrada válida heredada de deviceManagementSettingDefinition
documentationUrl Cadena Dirección URL para establecer la documentación heredada de deviceManagementSettingDefinition
headerTitle Cadena title del encabezado de configuración representa una categoría o sección de una configuración o configuración heredada de deviceManagementSettingDefinition
headerSubtitle Cadena subtítulo del encabezado de configuración para obtener más detalles sobre la categoría o sección Heredada de deviceManagementSettingDefinition
keywords Colección string Palabras clave asociadas a la configuración Heredada de deviceManagementSettingDefinition
Restricciones colección deviceManagementConstraint Colección de restricciones para el valor de configuración Heredado de deviceManagementSettingDefinition
Dependencias colección deviceManagementSettingDependency Colección de dependencias en otras configuraciones heredadas de deviceManagementSettingDefinition
propertyDefinitionIds Colección string Definiciones de cada propiedad de la configuración compleja

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementComplexSettingDefinition",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "propertyDefinitionIds": [
    "Property Definition Ids 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: 1143

{
  "@odata.type": "#microsoft.graph.deviceManagementComplexSettingDefinition",
  "id": "823ca4f9-a4f9-823c-f9a4-3c82f9a43c82",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "propertyDefinitionIds": [
    "Property Definition Ids value"
  ]
}
  • Last updated on