Atualizar deviceManagementExchangeConnectorUpdate deviceManagementExchangeConnector
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"
}