Criar deviceManagementConfigurationCategory

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para 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 deviceManagementConfigurationCategory .

Pré-requisitos

Uma das seguintes permissões é obrigató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/complianceCategories
POST /deviceManagement/configurationCategories

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto deviceManagementConfigurationCategory.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementConfigurationCategory.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Identificador do item
descrição	Cadeia de caracteres	Descrição do item
categoryDescription	Cadeia de Caracteres	Descrição do cabeçalho da categoria
Helptext	Cadeia de caracteres	Texto de ajuda do item
nome	Cadeia de caracteres	Nome do item
displayName	Cadeia de caracteres	Nome de exibição do item
Plataformas	deviceManagementConfigurationPlatforms	Tipos de plataformas, quais configurações na categoria têm. Os valores possíveis são: none, android, iOS, macOS, windows10X, windows10, linux, unknownFutureValue.
Tecnologias	deviceManagementConfigurationTechnologies	Tipos de tecnologias, quais configurações na categoria têm. Os valores possíveis são: none, mdm, windows10XManagement, configManager, appleRemoteManagement, microsoftSense, exchangeOnline, linuxMdm, enrollment, unknownFutureValue.
settingUsage	deviceManagementConfigurationSettingUsage	Indica que a categoria contém configurações usadas para Conformidade ou Configuração. Os valores possíveis são: none, configuration, compliance.
parentCategoryId	Cadeia de Caracteres	ID pai da categoria.
rootCategoryId	Cadeia de Caracteres	ID raiz da categoria.
childCategoryIds	String collection	Lista de IDs filho da categoria.

Resposta

Se tiver êxito, este método retornará um 201 Created código de resposta e um objeto deviceManagementConfigurationCategory no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationCategory",
  "description": "Description value",
  "categoryDescription": "Category Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "platforms": "android",
  "technologies": "mdm",
  "settingUsage": "configuration",
  "parentCategoryId": "Parent Category Id value",
  "rootCategoryId": "Root Category Id value",
  "childCategoryIds": [
    "Child Category Ids 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: 572

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationCategory",
  "id": "cff34dd2-4dd2-cff3-d24d-f3cfd24df3cf",
  "description": "Description value",
  "categoryDescription": "Category Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "platforms": "android",
  "technologies": "mdm",
  "settingUsage": "configuration",
  "parentCategoryId": "Parent Category Id value",
  "rootCategoryId": "Root Category Id value",
  "childCategoryIds": [
    "Child Category Ids value"
  ]
}