Atualizar deviceManagementExchangeConnectorUpdate deviceManagementExchangeConnector

  • 2 minutos para o fim da leitura

Namespace: microsoft.graphNamespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Atualizar as propriedades de um objeto deviceManagementExchangeConnector.Update the properties of a deviceManagementExchangeConnector object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP Request

PATCH /deviceManagement/exchangeConnectors/{deviceManagementExchangeConnectorId}

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto deviceManagementExchangeConnector.In the request body, supply a JSON representation for the deviceManagementExchangeConnector object.

A tabela a seguir mostra as propriedades obrigatórias ao criar deviceManagementExchangeConnector.The following table shows the properties that are required when you create the deviceManagementExchangeConnector.

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString Ainda não documentadoNot yet documented
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset Hora da última sincronização do Exchange ConnectorLast sync time for the Exchange Connector
statusstatus deviceManagementExchangeConnectorStatusdeviceManagementExchangeConnectorStatus Status do Exchange Connector.Exchange Connector Status. Os valores possíveis são: none, connectionPending, connected, disconnected.Possible values are: none, connectionPending, connected, disconnected.
primarySmtpAddressprimarySmtpAddress Cadeia de caracteresString Endereço de email usado para configurar o serviço a serviço do Exchange Connector.Email address used to configure the Service To Service Exchange Connector.
serverNameserverName Cadeia de caracteresString O nome do servidor Exchange.The name of the Exchange server.
connectorServerNameconnectorServerName Cadeia de caracteresString O nome do servidor que hospeda o Exchange Connector.The name of the server hosting the Exchange Connector.
exchangeConnectorTypeexchangeConnectorType deviceManagementExchangeConnectorTypedeviceManagementExchangeConnectorType O tipo de Exchange Connector configurado.The type of Exchange Connector Configured. Os valores possíveis são: onPremises, hosted, serviceToService, dedicated.Possible values are: onPremises, hosted, serviceToService, dedicated.
versãoversion Cadeia de caracteresString A versão do ExchangeConnectorAgentThe version of the ExchangeConnectorAgent
exchangeAliasexchangeAlias Cadeia de caracteresString Um alias atribuído a um servidor ExchangeAn alias assigned to the Exchange server
exchangeOrganizationexchangeOrganization Cadeia de caracteresString Organização do Exchange no servidor ExchangeExchange Organization to the Exchange server

RespostaResponse

Se bem-sucedido, esse método retornará um código de resposta 200 OK e um objeto deviceManagementExchangeConnector atualizado no corpo da resposta.If successful, this method returns a 200 OK response code and an updated deviceManagementExchangeConnector object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/exchangeConnectors/{deviceManagementExchangeConnectorId}
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"
}

RespostaResponse

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.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
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"
}