Criar deviceManagementConfigurationSettingGroupCollectionDefinition

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

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

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

Propriedade	Tipo	Descrição
Aplicabilidade	deviceManagementConfigurationSettingApplicability	Detalhes em qual configuração de dispositivo é aplicável. Dá suporte: $filters. Herdado de deviceManagementConfigurationSettingDefinition
Accesstypes	deviceManagementConfigurationSettingAccessTypes	Modo de acesso de leitura/gravação da configuração Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none, add, copy, delete, get, replace, execute.
palavras-chave	Coleção de cadeias de caracteres	Tokens que pesquisam configurações no Herdado de deviceManagementConfigurationSettingDefinition
infoUrls	Coleção String	Lista de links em que mais informações para a configuração podem ser encontradas. Herdado de deviceManagementConfigurationSettingDefinition
Ocorrência	deviceManagementConfigurationSettingOccurrence	Indica se a configuração é necessária ou não Herdada de deviceManagementConfigurationSettingDefinition
Baseuri	Cadeia de caracteres	Caminho CSP base herdado de deviceManagementConfigurationSettingDefinition
offsetUri	Cadeia de caracteres	Deslocamento do caminho CSP da base herdada do dispositivoManagementConfigurationSettingDefinition
rootDefinitionId	Cadeia de caracteres	ID de definição de configuração raiz se a configuração for uma configuração filho. Herdado de deviceManagementConfigurationSettingDefinition
Categoryid	Cadeia de caracteres	Especifique a categoria na qual a configuração está em. Suporte $filters. Herdado de deviceManagementConfigurationSettingDefinition
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. Herdado de deviceManagementConfigurationSettingDefinition. 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. Herdado de deviceManagementConfigurationSettingDefinition. 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. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none, settingsCatalog, template, unknownFutureValue.
referredSettingInformationList	coleção deviceManagementConfigurationReferredSettingInformation	Lista de informações de configuração mencionadas. Herdado de deviceManagementConfigurationSettingDefinition
id	Cadeia de caracteres	Identificador do item Herdado de deviceManagementConfigurationSettingDefinition
description	Cadeia de caracteres	Descrição da configuração. Herdado de deviceManagementConfigurationSettingDefinition
Helptext	Cadeia de caracteres	Texto de ajuda da configuração. Dê mais detalhes da configuraçã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 torradas. Herdado de deviceManagementConfigurationSettingDefinition
versão	Cadeia de caracteres	Versão do item herdada do dispositivoManagementConfigurationSettingDefinition
childIds	String collection	Configurações filho dependentes para esse grupo de configurações. Herdado de deviceManagementConfigurationSettingGroupDefinition
dependentOn	coleção deviceManagementConfigurationDependentOn	Lista de dependências para o grupo de configuração Herdado de deviceManagementConfigurationSettingGroupDefinition
dependedOnBy	coleção deviceManagementConfigurationSettingDependedOnBy	Lista de configurações filho que dependem dessa configuração Herdada de deviceManagementConfigurationSettingGroupDefinition
Maximumcount	Int32	Número máximo de contagem de grupos de configuração na coleção. Valores válidos de 1 a 100
minimumCount	Int32	Número mínimo de contagem de grupos de configuração na coleção. Valores válidos de 1 a 100

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto deviceManagementConfigurationSettingGroupCollectionDefinition 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: 1787

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
  "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
    }
  ],
  "maximumCount": 12,
  "minimumCount": 12
}

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
  "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": "739da194-a194-739d-94a1-9d7394a19d73",
  "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
    }
  ],
  "maximumCount": 12,
  "minimumCount": 12
}