更新 deviceManagementExchangeConnector
本文内容
命名空间:microsoft.graph
注意: 适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证 。
更新 deviceManagementExchangeConnector 对象的属性。
此 API 可用于以下国家级云部署 。
全局服务
美国政府 L4
美国政府 L5 (DOD)
由世纪互联运营的中国
✅
✅
✅
✅
权限
要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限 。
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All
委派(个人 Microsoft 帐户)
不支持。
应用程序
DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All
HTTP 请求
PATCH /deviceManagement/exchangeConnectors/{deviceManagementExchangeConnectorId}
标头
值
Authorization
持有者 {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"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new DeviceManagementExchangeConnector
{
OdataType = "#microsoft.graph.deviceManagementExchangeConnector",
LastSyncDateTime = DateTimeOffset.Parse("2017-01-01T00:02:49.3205976-08:00"),
Status = DeviceManagementExchangeConnectorStatus.ConnectionPending,
PrimarySmtpAddress = "Primary Smtp Address value",
ServerName = "Server Name value",
ConnectorServerName = "Connector Server Name value",
ExchangeConnectorType = DeviceManagementExchangeConnectorType.Hosted,
Version = "Version value",
ExchangeAlias = "Exchange Alias value",
ExchangeOrganization = "Exchange Organization value",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.ExchangeConnectors["{deviceManagementExchangeConnector-id}"].PatchAsync(requestBody);
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc device-management exchange-connectors patch --device-management-exchange-connector-id {deviceManagementExchangeConnector-id} --body '{\
"@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"\
}\
'
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
import (
"context"
"time"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodels.NewDeviceManagementExchangeConnector()
lastSyncDateTime , err := time.Parse(time.RFC3339, "2017-01-01T00:02:49.3205976-08:00")
requestBody.SetLastSyncDateTime(&lastSyncDateTime)
status := graphmodels.CONNECTIONPENDING_DEVICEMANAGEMENTEXCHANGECONNECTORSTATUS
requestBody.SetStatus(&status)
primarySmtpAddress := "Primary Smtp Address value"
requestBody.SetPrimarySmtpAddress(&primarySmtpAddress)
serverName := "Server Name value"
requestBody.SetServerName(&serverName)
connectorServerName := "Connector Server Name value"
requestBody.SetConnectorServerName(&connectorServerName)
exchangeConnectorType := graphmodels.HOSTED_DEVICEMANAGEMENTEXCHANGECONNECTORTYPE
requestBody.SetExchangeConnectorType(&exchangeConnectorType)
version := "Version value"
requestBody.SetVersion(&version)
exchangeAlias := "Exchange Alias value"
requestBody.SetExchangeAlias(&exchangeAlias)
exchangeOrganization := "Exchange Organization value"
requestBody.SetExchangeOrganization(&exchangeOrganization)
exchangeConnectors, err := graphClient.DeviceManagement().ExchangeConnectors().ByDeviceManagementExchangeConnectorId("deviceManagementExchangeConnector-id").Patch(context.Background(), requestBody, nil)
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DeviceManagementExchangeConnector deviceManagementExchangeConnector = new DeviceManagementExchangeConnector();
deviceManagementExchangeConnector.setOdataType("#microsoft.graph.deviceManagementExchangeConnector");
OffsetDateTime lastSyncDateTime = OffsetDateTime.parse("2017-01-01T00:02:49.3205976-08:00");
deviceManagementExchangeConnector.setLastSyncDateTime(lastSyncDateTime);
deviceManagementExchangeConnector.setStatus(DeviceManagementExchangeConnectorStatus.ConnectionPending);
deviceManagementExchangeConnector.setPrimarySmtpAddress("Primary Smtp Address value");
deviceManagementExchangeConnector.setServerName("Server Name value");
deviceManagementExchangeConnector.setConnectorServerName("Connector Server Name value");
deviceManagementExchangeConnector.setExchangeConnectorType(DeviceManagementExchangeConnectorType.Hosted);
deviceManagementExchangeConnector.setVersion("Version value");
deviceManagementExchangeConnector.setExchangeAlias("Exchange Alias value");
deviceManagementExchangeConnector.setExchangeOrganization("Exchange Organization value");
DeviceManagementExchangeConnector result = graphClient.deviceManagement().exchangeConnectors().byDeviceManagementExchangeConnectorId("{deviceManagementExchangeConnector-id}").patch(deviceManagementExchangeConnector);
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
const options = {
authProvider,
};
const client = Client.init(options);
const deviceManagementExchangeConnector = {
'@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'
};
await client.api('/deviceManagement/exchangeConnectors/{deviceManagementExchangeConnectorId}')
.update(deviceManagementExchangeConnector);
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\DeviceManagementExchangeConnector;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new DeviceManagementExchangeConnector();
$requestBody->setOdataType('#microsoft.graph.deviceManagementExchangeConnector');
$requestBody->setLastSyncDateTime(new \DateTime('2017-01-01T00:02:49.3205976-08:00'));
$requestBody->setStatus(new DeviceManagementExchangeConnectorStatus('connectionPending'));
$requestBody->setPrimarySmtpAddress('Primary Smtp Address value');
$requestBody->setServerName('Server Name value');
$requestBody->setConnectorServerName('Connector Server Name value');
$requestBody->setExchangeConnectorType(new DeviceManagementExchangeConnectorType('hosted'));
$requestBody->setVersion('Version value');
$requestBody->setExchangeAlias('Exchange Alias value');
$requestBody->setExchangeOrganization('Exchange Organization value');
$result = $graphServiceClient->deviceManagement()->exchangeConnectors()->byDeviceManagementExchangeConnectorId('deviceManagementExchangeConnector-id')->patch($requestBody)->wait();
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
Import-Module Microsoft.Graph.DeviceManagement.Administration
$params = @{
"@odata.type" = "#microsoft.graph.deviceManagementExchangeConnector"
lastSyncDateTime = [System.DateTime]::Parse("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"
}
Update-MgDeviceManagementExchangeConnector -DeviceManagementExchangeConnectorId $deviceManagementExchangeConnectorId -BodyParameter $params
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
from msgraph import GraphServiceClient
from msgraph.generated.models.device_management_exchange_connector import DeviceManagementExchangeConnector
graph_client = GraphServiceClient(credentials, scopes)
request_body = DeviceManagementExchangeConnector(
odata_type = "#microsoft.graph.deviceManagementExchangeConnector",
last_sync_date_time = "2017-01-01T00:02:49.3205976-08:00",
status = DeviceManagementExchangeConnectorStatus.ConnectionPending,
primary_smtp_address = "Primary Smtp Address value",
server_name = "Server Name value",
connector_server_name = "Connector Server Name value",
exchange_connector_type = DeviceManagementExchangeConnectorType.Hosted,
version = "Version value",
exchange_alias = "Exchange Alias value",
exchange_organization = "Exchange Organization value",
)
result = await graph_client.device_management.exchange_connectors.by_device_management_exchange_connector_id('deviceManagementExchangeConnector-id').patch(request_body)
有关如何将 SDK 添加 到项目并创建 authProvider 实例的详细信息,请参阅 SDK 文档 。
响应
下面是一个响应示例。 注意:为简洁起见,可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
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"
}