Crear deviceManagementComplexSettingDefinition

Espacio de nombres: microsoft.graph

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

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

Crea un nuevo objeto deviceManagementComplexSettingDefinition .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado 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 autenticación y 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 para crear la deviceManagementComplexSettingDefinition.

Propiedad Tipo Descripción
id Cadena El id. de la definición de configuración Heredado de deviceManagementSettingDefinition
tipo de valor deviceManangementIntentValueType El tipo de datos del valor Heredado de deviceManagementSettingDefinition. Los valores posibles son: integer, boolean, string, complex, collection, abstractComplex.
displayName Cadena El 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 configuración compleja o de colección Heredado de deviceManagementSettingDefinition
description Cadena Descripción de la configuración Heredado de deviceManagementSettingDefinition
placeholderText Cadena Texto de marcador de posición como ejemplo de entrada válida Heredado de deviceManagementSettingDefinition
documentationUrl Cadena Dirección URL a la documentación de configuración Heredado de deviceManagementSettingDefinition
headerTitle Cadena El título del encabezado de configuración representa una categoría o sección de una configuración Heredado de deviceManagementSettingDefinition
encabezadoSubtítulo Cadena subtítulo del encabezado de configuración para obtener más detalles sobre la categoría o sección Heredado de deviceManagementSettingDefinition
keywords Colección string Palabras clave asociadas a la configuración Heredado de deviceManagementSettingDefinition
Restricciones Recopilación deviceManagementConstraint Colección de restricciones para el valor de configuración Heredado de deviceManagementSettingDefinition
Dependencias Recopilación deviceManagementSettingDependency Recopilación de dependencias de otras configuraciones Heredado de deviceManagementSettingDefinition
propertyDefinitionIds Colección string Las definiciones de cada propiedad del entorno complejo

Respuesta

Si se realiza 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