Compartilhar via

Criar deviceComanagementAuthorityConfiguration

  • 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 deviceComanagementAuthorityConfiguration .

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) DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/deviceEnrollmentConfigurations

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

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

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador Exclusivo da conta Herdada de deviceEnrollmentConfiguration
displayName Cadeia de caracteres O nome a apresentar da configuração da inscrição de dispositivos Herdado de deviceEnrollmentConfiguration
description Cadeia de caracteres A descrição da configuração da inscrição de dispositivos Herdada de deviceEnrollmentConfiguration
prioridade Int32 A prioridade é utilizada quando um utilizador existe em vários grupos a que é atribuída a configuração de inscrição. Os utilizadores estão sujeitos apenas à configuração com o valor de prioridade mais baixo. Herdada do deviceEnrollmentConfiguration
createdDateTime DateTimeOffset Hora de data criada em UTC da configuração da inscrição de dispositivos Herdada de deviceEnrollmentConfiguration
lastModifiedDateTime DateTimeOffset Hora da última modificação em UTC da configuração da inscrição de dispositivos Herdada de deviceEnrollmentConfiguration
versão Int32 A versão da configuração da inscrição de dispositivos Herdada de deviceEnrollmentConfiguration
roleScopeTagIds String collection Etiquetas de âmbito de função opcionais para as restrições de inscrição. Herdada do deviceEnrollmentConfiguration
deviceEnrollmentConfigurationType deviceEnrollmentConfigurationType Suporte para o Tipo de Configuração de Inscrição Herdado de deviceEnrollmentConfiguration. Os valores possíveis são: unknown, limit, platformRestrictions, windowsHelloForBusiness, defaultLimit, defaultPlatformRestrictions, defaultWindowsHelloForBusiness, defaultWindows10EnrollmentCompletionPageConfiguration, windows10EnrollmentCompletionPageConfiguration, deviceComanagementAuthorityConfiguration, singlePlatformRestriction, unknownFutureValue e enrollmentNotificationsConfiguration.
managedDeviceAuthority Int32 Configuração da Autoridade de CoManagement ManagedDeviceAuthority
installConfigurationManagerAgent Booliano Configuração da Autoridade de CoManagement InstallConfigurationManagerAgent
configurationManagerAgentCommandLineArgument Cadeia de caracteres Configuração da Autoridade de CoManagement ConfigurationManagerAgentCommandLineArgument

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

{
  "@odata.type": "#microsoft.graph.deviceComanagementAuthorityConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "priority": 8,
  "version": 7,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "deviceEnrollmentConfigurationType": "limit",
  "managedDeviceAuthority": 6,
  "installConfigurationManagerAgent": true,
  "configurationManagerAgentCommandLineArgument": "Configuration Manager Agent Command Line Argument 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: 666

{
  "@odata.type": "#microsoft.graph.deviceComanagementAuthorityConfiguration",
  "id": "0ba0057f-057f-0ba0-7f05-a00b7f05a00b",
  "displayName": "Display Name value",
  "description": "Description value",
  "priority": 8,
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "version": 7,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "deviceEnrollmentConfigurationType": "limit",
  "managedDeviceAuthority": 6,
  "installConfigurationManagerAgent": true,
  "configurationManagerAgentCommandLineArgument": "Configuration Manager Agent Command Line Argument value"
}