更新 deviceManagementExchangeConnector

命名空间：microsoft.graph

注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。

更新 deviceManagementExchangeConnector 对象的属性。

权限

调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

PATCH /deviceManagement/exchangeConnectors/{deviceManagementExchangeConnectorId}

请求标头

标头	值
Authorization	Bearer <token>。必需。
接受	application/json

请求正文

在请求正文中，提供 deviceManagementExchangeConnector 对象的 JSON 表示形式。

下表显示创建 deviceManagementExchangeConnector 时所需的属性。

属性	类型	说明
id	String	尚未记录
lastSyncDateTime	DateTimeOffset	Exchange Connector 的上一次同步时间
status	deviceManagementExchangeConnectorStatus	Exchange 连接器状态。 可取值为：none、connectionPending、connected、disconnected、unknownFutureValue。
primarySmtpAddress	String	用于配置服务到服务 Exchange Connector 的电子邮件地址。
serverName	String	Exchange 服务器的名称。
connectorServerName	String	托管 Exchange Connector 的服务器的名称。
exchangeConnectorType	deviceManagementExchangeConnectorType	配置的 Exchange Connector 的类型。 可取值为：onPremises、hosted、serviceToService、dedicated、unknownFutureValue。
version	String	ExchangeConnectorAgent 版本
exchangeAlias	String	分配到 Exchange 服务器的别名
exchangeOrganization	String	Exchange 服务器的 Exchange 组织

响应

如果成功，此方法会在响应正文中返回 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"
}