Criar deviceManagementConfigurationSettingDefinition

  • Artigo

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto deviceManagementConfigurationSettingDefinition .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.ReadWrite.All

Solicitação 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

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto deviceManagementConfigurationSettingDefinition.

A tabela seguinte mostra as propriedades necessárias quando cria o dispositivoManagementConfigurationSettingDefinition.

Propriedade Tipo Descrição
aplicabilidade deviceManagementConfigurationSettingApplicability Detalhes sobre a definição do dispositivo aplicável. Suporta: $filters.
accessTypes deviceManagementConfigurationSettingAccessTypes Modo de acesso de leitura/escrita da definição. Os valores possíveis são: none, add, copy, delete, get, replace, execute.
palavras-chave Coleção String Tokens nos quais as definições de pesquisa estão ativadas
infoUrls Coleção String Pode encontrar uma lista de ligações mais informações para a definição em.
ocorrência deviceManagementConfigurationSettingOccurrence Indica se a definição é necessária ou não
baseUri Cadeia de caracteres Caminho CSP Base
offsetUri Cadeia de caracteres Desfasamento do Caminho CSP da Base
rootDefinitionId Cadeia de caracteres ID de definição de definição de raiz se a definição for uma definição subordinada.
categoryId Cadeia de caracteres Especifique a categoria na qual a definição se encontra. Suporte $filters.
settingUsage deviceManagementConfigurationSettingUsage Indique o tipo de definição para a definição. Os valores possíveis são: configuração, conformidade, reutilizávelDefinição. Cada utilização de definições tem um ponto final de API separado para chamar. Os valores possíveis são: none, configuration, compliance, unknownFutureValue, inventory.
uxBehavior deviceManagementConfigurationControlType Definir representação do tipo de controlo na experiência de utilizador. Os valores possíveis são: predefinição, lista pendente, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Os valores possíveis são: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane, unknownFutureValue.
visibility deviceManagementConfigurationSettingVisibility Definir o âmbito de visibilidade como UX. Os valores possíveis são: none, settingsCatalog, template. Os valores possíveis são: none, settingsCatalog, template, unknownFutureValue, inventoryCatalog.
referredSettingInformationList deviceManagementConfigurationReferredSettingInformation collection Lista de informações de definição referidas.
id Cadeia de caracteres Identificador do item
description Cadeia de caracteres Descrição da definição.
helpText Cadeia de caracteres Texto de ajuda da definição. Dê mais detalhes sobre a definição.
nome Cadeia de caracteres Nome do item
displayName Cadeia de caracteres Nome da configuração. Por exemplo: Permitir Alerta.
versão Cadeia de caracteres Versão do Item

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto deviceManagementConfigurationSettingDefinition no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

{
  "@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",
  "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"
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1309

{
  "@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",
  "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"
}