Actualizar mobileThreatDefenseConnector

Espacio de nombres: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto mobileThreatDefenseConnector.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/mobileThreatDefenseConnectors/{mobileThreatDefenseConnectorId}

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, especifique una representación JSON del objeto mobileThreatDefenseConnector.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto mobileThreatDefenseConnector.

Propiedad	Tipo	Descripción
id	Cadena	Todavía no documentado
lastHeartbeatDateTime	DateTimeOffset	Fecha y hora del último latido recibido del asociado de Mobile Threat Defense
partnerState	mobileThreatPartnerTenantState	Estado de asociado de Mobile Threat Defense para esta cuenta. Los valores posibles son: unavailable, available, enabled y unresponsive.
androidMobileApplicationManagementEnabled	Booleano	Cuando es TRUE, indica que los datos del asociado de Mobile Threat Defense se pueden usar durante las evaluaciones de Administración de aplicaciones móviles (MAM) para dispositivos Android. Cuando es FALSE, indica que los datos del asociado de Mobile Threat Defense no se deben usar durante las evaluaciones de Administración de aplicaciones móviles (MAM) para dispositivos Android. Solo se puede habilitar un asociado por plataforma para la evaluación de Mobile Application Management (MAM). El valor predeterminado es FALSE.
iosMobileApplicationManagementEnabled	Booleano	Cuando es TRUE, inidicates que los datos del asociado de Mobile Threat Defense se pueden usar durante las evaluaciones de administración de aplicaciones móviles (MAM) para dispositivos IOS. Cuando es FALSE, indica que los datos del asociado de Mobile Threat Defense no deben usarse durante las evaluaciones de administración de aplicaciones móviles (MAM) para dispositivos IOS. Solo se puede habilitar un asociado por plataforma para la evaluación de Mobile Application Management (MAM). El valor predeterminado es FALSE.
androidEnabled	Booleano	Para Android, establezca si los datos del asociado de Mobile Threat Defense deben usarse durante las evaluaciones de cumplimiento
iosEnabled	Booleano	Para IOS, obtenga o establezca si los datos del asociado de Mobile Threat Defense deben usarse durante las evaluaciones de cumplimiento.
windowsEnabled	Booleano	Cuando es TRUE, indica que los datos del asociado de Mobile Threat Defense se pueden usar durante las evaluaciones de cumplimiento para Windows. Cuando es FALSE, indica que los datos del asociado de Mobile Threat Defense no se deben usar durante las evaluaciones de cumplimiento para Windows. El valor predeterminado es FALSE.
androidDeviceBlockedOnMissingPartnerData	Booleano	Para Android, establezca si Intune debe recibir datos del asociado de Mobile Threat Defense antes de marcar un dispositivo conforme
iosDeviceBlockedOnMissingPartnerData	Booleano	Para IOS, establezca si Intune debe recibir datos del asociado de Mobile Threat Defense antes de marcar un dispositivo conforme
windowsDeviceBlockedOnMissingPartnerData	Booleano	Cuando es TRUE, los inidicates que Intune deben recibir datos del asociado de Mobile Threat Defense antes de marcar un dispositivo compatible con Windows. Cuando es FALSE, los inidicates que Intune pueden hacer que un dispositivo sea compatible sin recibir datos del asociado de Mobile Threat Defense para Windows. El valor predeterminado es FALSE.
partnerUnsupportedOsVersionBlocked	Booleano	Obtener o establecer si se bloquean los dispositivos en las plataformas habilitadas que no cumplen los requisitos mínimos de versión del asociado de Mobile Threat Defense
partnerUnresponsivenessThresholdInDays	Int32	Obtener o definir los días de tolerancia por espacio empresarial para la falta de respuesta de esta integración de partner.
allowPartnerToCollectIOSApplicationMetadata	Booleano	Cuando es TRUE, indica que el asociado de Mobile Threat Defense puede recopilar metadatos sobre las aplicaciones instaladas de Intune para dispositivos IOS. Cuando es FALSE, indica que es posible que el asociado de Mobile Threat Defense no recopile metadatos sobre las aplicaciones instaladas de Intune para dispositivos IOS. El valor predeterminado es FALSE.
allowPartnerToCollectIOSPersonalApplicationMetadata	Booleano	Cuando es TRUE, indica que el asociado de Mobile Threat Defense puede recopilar metadatos sobre las aplicaciones instaladas personalmente de Intune para dispositivos IOS. Cuando es FALSE, indica que es posible que el asociado de Mobile Threat Defense no recopile metadatos sobre las aplicaciones instaladas personalmente de Intune para dispositivos IOS. El valor predeterminado es FALSE.
microsoftDefenderForEndpointAttachEnabled	Booleano	Cuando es TRUE, inidicate esa administración de perfiles de configuración a través de Microsoft Defender para punto de conexión está habilitada. Cuando es FALSE, indica que la administración de perfiles de configuración a través de Microsoft Defender para punto de conexión está deshabilitada. El valor predeterminado es FALSE.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto mobileThreatDefenseConnector actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

HTTP

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
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new MobileThreatDefenseConnector
{
	OdataType = "#microsoft.graph.mobileThreatDefenseConnector",
	LastHeartbeatDateTime = DateTimeOffset.Parse("2016-12-31T23:59:37.9174975-08:00"),
	PartnerState = MobileThreatPartnerTenantState.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,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.MobileThreatDefenseConnectors["{mobileThreatDefenseConnector-id}"].PatchAsync(requestBody);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

CLI

mgc device-management mobile-threat-defense-connectors patch --mobile-threat-defense-connector-id {mobileThreatDefenseConnector-id} --body '{\
  "@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\
}\
'

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Ir

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  "time"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewMobileThreatDefenseConnector()
lastHeartbeatDateTime , err := time.Parse(time.RFC3339, "2016-12-31T23:59:37.9174975-08:00")
requestBody.SetLastHeartbeatDateTime(&lastHeartbeatDateTime) 
partnerState := graphmodels.AVAILABLE_MOBILETHREATPARTNERTENANTSTATE 
requestBody.SetPartnerState(&partnerState) 
androidMobileApplicationManagementEnabled := true
requestBody.SetAndroidMobileApplicationManagementEnabled(&androidMobileApplicationManagementEnabled) 
iosMobileApplicationManagementEnabled := true
requestBody.SetIosMobileApplicationManagementEnabled(&iosMobileApplicationManagementEnabled) 
androidEnabled := true
requestBody.SetAndroidEnabled(&androidEnabled) 
iosEnabled := true
requestBody.SetIosEnabled(&iosEnabled) 
windowsEnabled := true
requestBody.SetWindowsEnabled(&windowsEnabled) 
androidDeviceBlockedOnMissingPartnerData := true
requestBody.SetAndroidDeviceBlockedOnMissingPartnerData(&androidDeviceBlockedOnMissingPartnerData) 
iosDeviceBlockedOnMissingPartnerData := true
requestBody.SetIosDeviceBlockedOnMissingPartnerData(&iosDeviceBlockedOnMissingPartnerData) 
windowsDeviceBlockedOnMissingPartnerData := true
requestBody.SetWindowsDeviceBlockedOnMissingPartnerData(&windowsDeviceBlockedOnMissingPartnerData) 
partnerUnsupportedOsVersionBlocked := true
requestBody.SetPartnerUnsupportedOsVersionBlocked(&partnerUnsupportedOsVersionBlocked) 
partnerUnresponsivenessThresholdInDays := int32(6)
requestBody.SetPartnerUnresponsivenessThresholdInDays(&partnerUnresponsivenessThresholdInDays) 
allowPartnerToCollectIOSApplicationMetadata := true
requestBody.SetAllowPartnerToCollectIOSApplicationMetadata(&allowPartnerToCollectIOSApplicationMetadata) 
allowPartnerToCollectIOSPersonalApplicationMetadata := true
requestBody.SetAllowPartnerToCollectIOSPersonalApplicationMetadata(&allowPartnerToCollectIOSPersonalApplicationMetadata) 
microsoftDefenderForEndpointAttachEnabled := true
requestBody.SetMicrosoftDefenderForEndpointAttachEnabled(&microsoftDefenderForEndpointAttachEnabled) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
mobileThreatDefenseConnectors, err := graphClient.DeviceManagement().MobileThreatDefenseConnectors().ByMobileThreatDefenseConnectorId("mobileThreatDefenseConnector-id").Patch(context.Background(), requestBody, nil)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

MobileThreatDefenseConnector mobileThreatDefenseConnector = new MobileThreatDefenseConnector();
mobileThreatDefenseConnector.setOdataType("#microsoft.graph.mobileThreatDefenseConnector");
OffsetDateTime lastHeartbeatDateTime = OffsetDateTime.parse("2016-12-31T23:59:37.9174975-08:00");
mobileThreatDefenseConnector.setLastHeartbeatDateTime(lastHeartbeatDateTime);
mobileThreatDefenseConnector.setPartnerState(MobileThreatPartnerTenantState.Available);
mobileThreatDefenseConnector.setAndroidMobileApplicationManagementEnabled(true);
mobileThreatDefenseConnector.setIosMobileApplicationManagementEnabled(true);
mobileThreatDefenseConnector.setAndroidEnabled(true);
mobileThreatDefenseConnector.setIosEnabled(true);
mobileThreatDefenseConnector.setWindowsEnabled(true);
mobileThreatDefenseConnector.setAndroidDeviceBlockedOnMissingPartnerData(true);
mobileThreatDefenseConnector.setIosDeviceBlockedOnMissingPartnerData(true);
mobileThreatDefenseConnector.setWindowsDeviceBlockedOnMissingPartnerData(true);
mobileThreatDefenseConnector.setPartnerUnsupportedOsVersionBlocked(true);
mobileThreatDefenseConnector.setPartnerUnresponsivenessThresholdInDays(6);
mobileThreatDefenseConnector.setAllowPartnerToCollectIOSApplicationMetadata(true);
mobileThreatDefenseConnector.setAllowPartnerToCollectIOSPersonalApplicationMetadata(true);
mobileThreatDefenseConnector.setMicrosoftDefenderForEndpointAttachEnabled(true);
MobileThreatDefenseConnector result = graphClient.deviceManagement().mobileThreatDefenseConnectors().byMobileThreatDefenseConnectorId("{mobileThreatDefenseConnector-id}").patch(mobileThreatDefenseConnector);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const mobileThreatDefenseConnector = {
  '@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
};

await client.api('/deviceManagement/mobileThreatDefenseConnectors/{mobileThreatDefenseConnectorId}')
	.update(mobileThreatDefenseConnector);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\MobileThreatDefenseConnector;
use Microsoft\Graph\Generated\Models\MobileThreatPartnerTenantState;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new MobileThreatDefenseConnector();
$requestBody->setOdataType('#microsoft.graph.mobileThreatDefenseConnector');
$requestBody->setLastHeartbeatDateTime(new \DateTime('2016-12-31T23:59:37.9174975-08:00'));
$requestBody->setPartnerState(new MobileThreatPartnerTenantState('available'));
$requestBody->setAndroidMobileApplicationManagementEnabled(true);
$requestBody->setIosMobileApplicationManagementEnabled(true);
$requestBody->setAndroidEnabled(true);
$requestBody->setIosEnabled(true);
$requestBody->setWindowsEnabled(true);
$requestBody->setAndroidDeviceBlockedOnMissingPartnerData(true);
$requestBody->setIosDeviceBlockedOnMissingPartnerData(true);
$requestBody->setWindowsDeviceBlockedOnMissingPartnerData(true);
$requestBody->setPartnerUnsupportedOsVersionBlocked(true);
$requestBody->setPartnerUnresponsivenessThresholdInDays(6);
$requestBody->setAllowPartnerToCollectIOSApplicationMetadata(true);
$requestBody->setAllowPartnerToCollectIOSPersonalApplicationMetadata(true);
$requestBody->setMicrosoftDefenderForEndpointAttachEnabled(true);

$result = $graphServiceClient->deviceManagement()->mobileThreatDefenseConnectors()->byMobileThreatDefenseConnectorId('mobileThreatDefenseConnector-id')->patch($requestBody)->wait();

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PowerShell

Import-Module Microsoft.Graph.DeviceManagement.Administration

$params = @{
	"@odata.type" = "#microsoft.graph.mobileThreatDefenseConnector"
	lastHeartbeatDateTime = [System.DateTime]::Parse("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
}

Update-MgDeviceManagementMobileThreatDefenseConnector -MobileThreatDefenseConnectorId $mobileThreatDefenseConnectorId -BodyParameter $params

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.mobile_threat_defense_connector import MobileThreatDefenseConnector
from msgraph.generated.models.mobile_threat_partner_tenant_state import MobileThreatPartnerTenantState
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = MobileThreatDefenseConnector(
	odata_type = "#microsoft.graph.mobileThreatDefenseConnector",
	last_heartbeat_date_time = "2016-12-31T23:59:37.9174975-08:00",
	partner_state = MobileThreatPartnerTenantState.Available,
	android_mobile_application_management_enabled = True,
	ios_mobile_application_management_enabled = True,
	android_enabled = True,
	ios_enabled = True,
	windows_enabled = True,
	android_device_blocked_on_missing_partner_data = True,
	ios_device_blocked_on_missing_partner_data = True,
	windows_device_blocked_on_missing_partner_data = True,
	partner_unsupported_os_version_blocked = True,
	partner_unresponsiveness_threshold_in_days = 6,
	allow_partner_to_collect_i_o_s_application_metadata = True,
	allow_partner_to_collect_i_o_s_personal_application_metadata = True,
	microsoft_defender_for_endpoint_attach_enabled = True,
)

result = await graph_client.device_management.mobile_threat_defense_connectors.by_mobile_threat_defense_connector_id('mobileThreatDefenseConnector-id').patch(request_body)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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
}