deviceManagementExchangeConnector の更新

[アーティクル]
03/15/2023

名前空間: 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}

要求ヘッダー

ヘッダー	値
承認	ベアラー <トークン> が必要です。
承諾	application/json

要求本文

要求本文で、deviceManagementExchangeConnector オブジェクトの JSON 表記を指定します。

次の表に、deviceManagementExchangeConnector の作成時に必要なプロパティを示します。

プロパティ	型	説明
id	String	まだ文書化されていません
lastSyncDateTime	DateTimeOffset	Exchange Connector の最終同期日時
status	deviceManagementExchangeConnectorStatus	Exchange コネクタの状態。可能な値は、`none`、`connectionPending`、`connected`、`disconnected`、`unknownFutureValue` です。
primarySmtpAddress	String	サービス間の Exchange Connector を構成するときに使用するメールアドレス。
serverName	文字列	Exchange サーバーの名前。
connectorServerName	文字列	Exchange Connector をホストするサーバーの名前。
exchangeConnectorType	deviceManagementExchangeConnectorType	構成されている Exchange Connector の種類。可能な値は、`onPremises`、`hosted`、`serviceToService`、`dedicated`、`unknownFutureValue` です。
version	String	ExchangeConnectorAgent のバージョン
exchangeAlias	String	Exchange Server に割り当てられているエイリアス。
exchangeOrganization	String	Exchange Server に対する 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"
}