更新 mobileThreatDefenseConnector

命名空间:microsoft.graph

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

更新 mobileThreatDefenseConnector 对象的属性。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

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

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

HTTP 请求

PATCH /deviceManagement/mobileThreatDefenseConnectors/{mobileThreatDefenseConnectorId}

请求标头

标头
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
接受 application/json

请求正文

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

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

属性 类型 说明
id String 尚未记录
lastHeartbeatDateTime DateTimeOffset 从移动威胁防御合作伙伴收到的上次检测信号的日期时间
partnerState mobileThreatPartnerTenantState 此帐户的移动威胁防御合作伙伴状态。 可能的值是:unavailableavailableenabledunresponsive
androidMobileApplicationManagementEnabled 布尔值 如果为 TRUE,则移动威胁防御合作伙伴的数据可在移动应用程序管理 (MAM) Android 设备的评估期间使用。 如果为 FALSE,则不应在移动应用程序管理期间使用来自移动威胁防御合作伙伴的数据, (MAM) Android 设备的评估。 每个平台只能为移动应用程序管理启用一个合作伙伴, (MAM) 评估。 默认值为 FALSE。
iosMobileApplicationManagementEnabled 布尔值 如果为 TRUE,则移动威胁防御合作伙伴的数据可以在移动应用程序管理期间使用, (MAM) IOS 设备的评估。 如果为 FALSE,则不应在移动应用程序管理期间使用来自移动威胁防御合作伙伴的数据, (MAM) IOS 设备的评估。 每个平台只能为移动应用程序管理启用一个合作伙伴, (MAM) 评估。 默认值为 FALSE。
androidEnabled 布尔值 对于 Android,设置是否应在合规性评估期间使用来自移动威胁防御合作伙伴的数据
iosEnabled 布尔值 对于 IOS,获取或设置是否应在合规性评估期间使用来自移动威胁防御合作伙伴的数据
windowsEnabled 布尔值 如果为 TRUE,则会在 Windows 的合规性评估期间使用来自移动威胁防御合作伙伴的数据。 如果为 FALSE,则不应在 Windows 的合规性评估期间使用移动威胁防御合作伙伴的数据。 默认值为 FALSE。
androidDeviceBlockedOnMissingPartnerData 布尔值 对于 Android,设置Intune是否必须在将设备标记为合规之前从移动威胁防御合作伙伴接收数据
iosDeviceBlockedOnMissingPartnerData 布尔值 对于 IOS,设置Intune是否必须在将设备标记为合规之前从移动威胁防御合作伙伴接收数据
windowsDeviceBlockedOnMissingPartnerData 布尔值 如果为 TRUE,则Intune必须在将设备标记为符合 Windows 之前从移动威胁防御合作伙伴接收数据。 如果为 FALSE,则Intune可能会使设备合规,而无需从适用于 Windows 的移动威胁防御合作伙伴接收数据。 默认值为 FALSE。
partnerUnsupportedOsVersionBlocked 布尔值 获取或设置是否阻止未满足移动威胁防御合作伙伴最低版本要求的已启用平台上的设备
partnerUnresponsivenessThresholdInDays Int32 获取或设置每个租户允许此合作伙伴集成不响应的天数
allowPartnerToCollectIOSApplicationMetadata 布尔值 如果为 TRUE,则表示移动威胁防御合作伙伴可能会从 IOS 设备的Intune收集有关已安装应用程序的元数据。 如果为 FALSE,则表示移动威胁防御合作伙伴可能不会从 IOS 设备的Intune收集有关已安装应用程序的元数据。 默认值为 FALSE。
allowPartnerToCollectIOSPersonalApplicationMetadata 布尔值 如果为 TRUE,则表示移动威胁防御合作伙伴可能会从 IOS 设备的Intune收集有关个人安装的应用程序的元数据。 如果为 FALSE,则表示移动威胁防御合作伙伴可能不会从 IOS 设备的Intune收集有关个人安装应用程序的元数据。 默认值为 FALSE。
microsoftDefenderForEndpointAttachEnabled 布尔值 如果为 TRUE,则启用通过 Microsoft Defender for Endpoint 进行配置文件管理。 如果为 FALSE,则禁用通过 Microsoft Defender for Endpoint 进行配置文件管理。 默认值为 FALSE。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新的 mobileThreatDefenseConnector 对象。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/v1.0/deviceManagement/mobileThreatDefenseConnectors/{mobileThreatDefenseConnectorId}
Content-type: application/json
Content-length: 772

{
  "@odata.type": "#microsoft.graph.mobileThreatDefenseConnector",
  "lastHeartbeatDateTime": "2016-12-31T23:59:37.9174975-08:00",
  "partnerState": "available",
  "androidMobileApplicationManagementEnabled": true,
  "iosMobileApplicationManagementEnabled": true,
  "androidEnabled": true,
  "iosEnabled": true,
  "windowsEnabled": true,
  "androidDeviceBlockedOnMissingPartnerData": true,
  "iosDeviceBlockedOnMissingPartnerData": true,
  "windowsDeviceBlockedOnMissingPartnerData": true,
  "partnerUnsupportedOsVersionBlocked": true,
  "partnerUnresponsivenessThresholdInDays": 6,
  "allowPartnerToCollectIOSApplicationMetadata": true,
  "allowPartnerToCollectIOSPersonalApplicationMetadata": true,
  "microsoftDefenderForEndpointAttachEnabled": true
}

响应

下面是一个响应示例。 注意:为简洁起见,可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 821

{
  "@odata.type": "#microsoft.graph.mobileThreatDefenseConnector",
  "id": "e4bede14-de14-e4be-14de-bee414debee4",
  "lastHeartbeatDateTime": "2016-12-31T23:59:37.9174975-08:00",
  "partnerState": "available",
  "androidMobileApplicationManagementEnabled": true,
  "iosMobileApplicationManagementEnabled": true,
  "androidEnabled": true,
  "iosEnabled": true,
  "windowsEnabled": true,
  "androidDeviceBlockedOnMissingPartnerData": true,
  "iosDeviceBlockedOnMissingPartnerData": true,
  "windowsDeviceBlockedOnMissingPartnerData": true,
  "partnerUnsupportedOsVersionBlocked": true,
  "partnerUnresponsivenessThresholdInDays": 6,
  "allowPartnerToCollectIOSApplicationMetadata": true,
  "allowPartnerToCollectIOSPersonalApplicationMetadata": true,
  "microsoftDefenderForEndpointAttachEnabled": true
}