Criar deviceManagementConfigurationSettingDefinition

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.

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 .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA 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.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/reusableSettings
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 da solicitação, forneça uma representação JSON para o objeto deviceManagementConfigurationSettingDefinition.

A tabela a seguir mostra as propriedades necessárias ao criar o dispositivoManagementConfigurationSettingDefinition.

Propriedade	Tipo	Descrição
Aplicabilidade	deviceManagementConfigurationSettingApplicability	Detalhes em qual configuração de dispositivo é aplicável. Dá suporte: $filters.
Accesstypes	deviceManagementConfigurationSettingAccessTypes	Modo de acesso de leitura/gravação da configuração. Os valores possíveis são: none, add, copy, delete, get, replace, execute.
palavras-chave	String collection	Tokens nos quais pesquisar configurações
infoUrls	Coleção de cadeias de caracteres	Lista de links em que mais informações para a configuração podem ser encontradas.
Ocorrência	deviceManagementConfigurationSettingOccurrence	Indica se a configuração é necessária ou não
Baseuri	Cadeia de caracteres	Caminho CSP base
offsetUri	Cadeia de caracteres	Deslocamento do caminho CSP da base
rootDefinitionId	Cadeia de caracteres	ID de definição de configuração raiz se a configuração for uma configuração filho.
Categoryid	Cadeia de caracteres	Especifique a categoria na qual a configuração está em. Suporte $filters.
settingUsage	deviceManagementConfigurationSettingUsage	Indique o tipo de configuração para a configuração. Os valores possíveis são: configuração, conformidade, reusableSetting. Cada uso de configuração tem ponto de extremidade de API separado para chamar. Os valores possíveis são: none, configuration, compliance, unknownFutureValue.
uxBehavior	deviceManagementConfigurationControlType	Configurando a representação do tipo de controle no UX. Os valores possíveis são: padrão, suspenso, smallTextBox, largeTextBox, alternância, multiheaderGrid, contextPane. Os valores possíveis são: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane, unknownFutureValue.
visibility	deviceManagementConfigurationSettingVisibility	Definindo o escopo de visibilidade como UX. Os valores possíveis são: nenhum, configuraçõesCatalog, modelo. Os valores possíveis são: none, settingsCatalog, template, unknownFutureValue.
referredSettingInformationList	coleção deviceManagementConfigurationReferredSettingInformation	Lista de informações de configuração mencionadas.
id	Cadeia de caracteres	Identificador para item
description	Cadeia de caracteres	Descrição da configuração.
Helptext	Cadeia de caracteres	Texto de ajuda da configuração. Dê mais detalhes da configuração.
nome	Cadeia de caracteres	Nome do item
displayName	Cadeia de caracteres	Nome da configuração. Por exemplo: Permitir torradas.
versão	Cadeia de caracteres	Versão do item

Resposta

Se for bem-sucedido, esse método retornará 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"
}