Criar deviceManagementConfigurationSettingGroupDefinition

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

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

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

Propriedade Tipo Descrição
aplicabilidade deviceManagementConfigurationSettingApplicability Detalhes sobre a definição do dispositivo aplicável. Suporta: $filters. Herdado de deviceManagementConfigurationSettingDefinition
accessTypes deviceManagementConfigurationSettingAccessTypes Modo de acesso de leitura/escrita da definição Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none, add, copy, delete, get, replace, execute.
palavras-chave String collection Tokens para procurar definições em Herdado de deviceManagementConfigurationSettingDefinition
infoUrls Coleção String Pode encontrar uma lista de ligações mais informações para a definição em. Herdado de deviceManagementConfigurationSettingDefinition
ocorrência deviceManagementConfigurationSettingOccurrence Indica se a definição é necessária ou não Herdada de deviceManagementConfigurationSettingDefinition
baseUri Cadeia de caracteres Caminho CSP Base Herdado de deviceManagementConfigurationSettingDefinition
offsetUri Cadeia de caracteres Desvio do Caminho CSP da Base Herdada de deviceManagementConfigurationSettingDefinition
rootDefinitionId Cadeia de caracteres ID de definição de definição de raiz se a definição for uma definição subordinada. Herdado de deviceManagementConfigurationSettingDefinition
categoryId Cadeia de caracteres Especifique a categoria na qual a definição se encontra. Suporte $filters. Herdado de deviceManagementConfigurationSettingDefinition
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. Herdado de deviceManagementConfigurationSettingDefinition. 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. Herdado de deviceManagementConfigurationSettingDefinition. 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. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none, settingsCatalog, template, unknownFutureValue, inventoryCatalog.
referredSettingInformationList deviceManagementConfigurationReferredSettingInformation collection Lista de informações de definição referidas. Herdado de deviceManagementConfigurationSettingDefinition
id Cadeia de caracteres Identificador do item Herdado de deviceManagementConfigurationSettingDefinition
description Cadeia de caracteres Descrição da definição. Herdado de deviceManagementConfigurationSettingDefinition
helpText Cadeia de caracteres Texto de ajuda da definição. Dê mais detalhes sobre a definição. Herdado de deviceManagementConfigurationSettingDefinition
nome Cadeia de caracteres Nome do item Herdado de deviceManagementConfigurationSettingDefinition
displayName Cadeia de caracteres Nome da configuração. Por exemplo: Permitir Alerta. Herdado de deviceManagementConfigurationSettingDefinition
versão Cadeia de caracteres Versão do Item Herdada de deviceManagementConfigurationSettingDefinition
childIds Coleção String Definições subordinadas dependentes deste grupo de definições.
dependenteOn deviceManagementConfigurationDependentOn collection Lista de Dependências do grupo de definições
dependedOnBy deviceManagementConfigurationSettingDependedOnBy collection Lista de definições subordinadas que dependem desta definição

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto deviceManagementConfigurationSettingGroupDefinition 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: 1731

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "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",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "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": "95dc9604-9604-95dc-0496-dc950496dc95",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}