Criar deviceManagementExchangeConnector

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto deviceManagementExchangeConnector.

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)
Delegada (conta corporativa ou de estudante) DeviceManagementServiceConfig.ReadWrite.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo DeviceManagementServiceConfig.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/exchangeConnectors

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

A tabela a seguir mostra as propriedades obrigatórias ao criar deviceManagementExchangeConnector.

Propriedade Tipo Descrição
id String Ainda não documentado
lastSyncDateTime DateTimeOffset Hora da última sincronização do Exchange Connector
status deviceManagementExchangeConnectorStatus Status do Conector do Exchange. Os valores possíveis são: none, connectionPending, connected, disconnected.
primarySmtpAddress Cadeia de caracteres Endereço de email usado para configurar o serviço a serviço do Exchange Connector.
serverName Cadeia de caracteres O nome do servidor Exchange.
connectorServerName Cadeia de caracteres O nome do servidor que hospeda o Exchange Connector.
exchangeConnectorType deviceManagementExchangeConnectorType O tipo de Exchange Connector configurado. Os valores possíveis são: onPremises, hosted, serviceToService, dedicated.
versão Cadeia de caracteres A versão do ExchangeConnectorAgent
exchangeAlias Cadeia de caracteres Um alias atribuído a um servidor Exchange
exchangeOrganization Cadeia de caracteres Organização do Exchange no servidor Exchange

Resposta

Se bem-sucedido, esse método retornará um código de resposta 201 Created e um objeto deviceManagementExchangeConnector no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/v1.0/deviceManagement/exchangeConnectors
Content-type: application/json
Content-length: 490

{
  "@odata.type": "#microsoft.graph.deviceManagementExchangeConnector",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "status": "connectionPending",
  "primarySmtpAddress": "Primary Smtp Address value",
  "serverName": "Server Name value",
  "connectorServerName": "Connector Server Name value",
  "exchangeConnectorType": "hosted",
  "version": "Version value",
  "exchangeAlias": "Exchange Alias value",
  "exchangeOrganization": "Exchange Organization 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: 539

{
  "@odata.type": "#microsoft.graph.deviceManagementExchangeConnector",
  "id": "e11c1de8-1de8-e11c-e81d-1ce1e81d1ce1",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "status": "connectionPending",
  "primarySmtpAddress": "Primary Smtp Address value",
  "serverName": "Server Name value",
  "connectorServerName": "Connector Server Name value",
  "exchangeConnectorType": "hosted",
  "version": "Version value",
  "exchangeAlias": "Exchange Alias value",
  "exchangeOrganization": "Exchange Organization value"
}