Поделиться через


Обновление объекта deviceManagementExchangeConnector

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновление свойств объекта deviceManagementExchangeConnector.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

PATCH /deviceManagement/exchangeConnectors/{deviceManagementExchangeConnectorId}

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept application/json

Текст запроса

В теле запроса добавьте представление объекта deviceManagementExchangeConnector в формате JSON.

Ниже показаны свойства, которые необходимо указывать при создании объекта deviceManagementExchangeConnector.

Свойство Тип Описание
id String Н/Д
lastSyncDateTime DateTimeOffset Время последней синхронизации соединителя Exchange
status deviceManagementExchangeConnectorStatus Состояние соединителя Exchange. Возможные значения: none, connectionPending, connected, disconnected, unknownFutureValue.
primarySmtpAddress String Электронный адрес, используемый для настройки соединителя Exchange между службами.
serverName String Имя сервера Exchange Server.
connectorServerName String Имя сервера, на котором размещается соединитель Exchange.
exchangeConnectorType deviceManagementExchangeConnectorType Тип настраиваемого соединителя Exchange. Возможные значения: onPremises, hosted, serviceToService, dedicated, unknownFutureValue.
version String Версия объекта ExchangeConnectorAgent
exchangeAlias String Псевдоним, назначенный серверу Exchange Server
exchangeOrganization String Организация Exchange, соответствующая серверу Exchange Server

Отклик

В случае успешного выполнения этот метод возвращает код ответа 200 OK и обновленный объект deviceManagementExchangeConnector в теле ответа.

Пример

Запрос

Ниже приведен пример запроса.

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"
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

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"
}