Criar mobileThreatDefenseConnector

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Cria um novo objeto mobileThreatDefenseConnector.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/mobileThreatDefenseConnectors

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto mobileThreatDefenseConnector.

A tabela a seguir mostra as propriedades obrigatórias ao criar mobileThreatDefenseConnector.

Propriedade	Tipo	Descrição
id	String	Ainda não documentado
lastHeartbeatDateTime	DateTimeOffset	DateTime do último Heartbeat recebido do parceiro de Defesa contra Ameaças Móveis
partnerState	mobileThreatPartnerTenantState	Estado do parceiro de Defesa contra Ameaças Móveis para essa conta. Os valores possíveis são: unavailable, available, enabled, unresponsive.
androidMobileApplicationManagementEnabled	Booliano	Quando TRUE, inidica esses dados do parceiro de Defesa contra Ameaças Móveis podem ser usados durante avaliações de MAM (Gerenciamento de Aplicativos Móveis) para dispositivos Android. Quando FALSE, indispõe que os dados do parceiro de Defesa contra Ameaças Móveis não devem ser usados durante avaliações de MAM (Gerenciamento de Aplicativos Móveis) para dispositivos Android. Somente um parceiro por plataforma pode estar habilitado para avaliação do MAM (Gerenciamento de Aplicativos Móveis). O valor padrão é FALSE.
iosMobileApplicationManagementEnabled	Booliano	Quando TRUE, inidica esses dados do parceiro de Defesa contra Ameaças Móveis podem ser usados durante avaliações de MAM (Gerenciamento de Aplicativos Móveis) para dispositivos IOS. Quando FALSE, indispõe que os dados do parceiro de Defesa contra Ameaças Móveis não devem ser usados durante avaliações de MAM (Gerenciamento de Aplicativos Móveis) para dispositivos IOS. Somente um parceiro por plataforma pode estar habilitado para avaliação do MAM (Gerenciamento de Aplicativos Móveis). O valor padrão é FALSE.
androidEnabled	Booliano	Para Android, defina se os dados do parceiro de Defesa contra Ameaças Móveis devem ser usados durante avaliações de conformidade
iosEnabled	Booliano	Para IOS, obtenha ou defina se os dados do parceiro de Defesa contra Ameaças Móveis devem ser usados durante avaliações de conformidade
windowsEnabled	Booliano	Quando TRUE, inidica esses dados do parceiro de Defesa contra Ameaças Móveis podem ser usados durante avaliações de conformidade para Windows. Quando FALSE, indispõe que os dados do parceiro de Defesa contra Ameaças Móveis não devem ser usados durante avaliações de conformidade para Windows. O valor padrão é FALSE.
androidDeviceBlockedOnMissingPartnerData	Booliano	Para Android, defina se Intune deve receber dados do parceiro de Defesa contra Ameaças Móveis antes de marcar um dispositivo compatível com
iosDeviceBlockedOnMissingPartnerData	Booliano	Para IOS, defina se Intune deve receber dados do parceiro de Defesa contra Ameaças Móveis antes de marcar um dispositivo compatível com
windowsDeviceBlockedOnMissingPartnerData	Booliano	Quando TRUE, inidica esse Intune deve receber dados do parceiro de Defesa contra Ameaças Móveis antes de marcar um dispositivo compatível com o Windows. Quando FALSE, inidica esse Intune pode tornar um dispositivo compatível sem receber dados do parceiro de Defesa contra Ameaças Móveis para Windows. O valor padrão é FALSE.
partnerUnsupportedOsVersionBlocked	Booliano	Obter ou definir se deve bloquear dispositivos nas plataformas habilitadas que não atendem aos requisitos mínimos de versão do parceiro de Defesa contra Ameaças Móveis
partnerUnresponsivenessThresholdInDays	Int32	Obtém ou define dias de tolerância por locatário à falta de resposta para esta integração de parceiro
allowPartnerToCollectIOSApplicationMetadata	Booliano	Quando TRUE, indica que o parceiro de Defesa contra Ameaças Móveis pode coletar metadados sobre aplicativos instalados de Intune para dispositivos IOS. Quando FALSE, indica que o parceiro de Defesa contra Ameaças Móveis pode não coletar metadados sobre aplicativos instalados de Intune para dispositivos IOS. O valor padrão é FALSE.
allowPartnerToCollectIOSPersonalApplicationMetadata	Booliano	Quando TRUE, indica que o parceiro de Defesa contra Ameaças Móveis pode coletar metadados sobre aplicativos instalados pessoalmente de Intune para dispositivos IOS. Quando FALSE, indica que o parceiro de Defesa contra Ameaças Móveis pode não coletar metadados sobre aplicativos instalados pessoalmente de Intune para dispositivos IOS. O valor padrão é FALSE.
microsoftDefenderForEndpointAttachEnabled	Booliano	Quando TRUE, indispõe esse gerenciamento de perfil de configuração por meio de Microsoft Defender para Ponto de Extremidade está habilitado. Quando FALSE, indispõe esse gerenciamento de perfil de configuração por meio de Microsoft Defender para Ponto de Extremidade é desabilitado. O valor padrão é FALSE.

Resposta

Se tiver êxito, este método retornará um código de resposta 201 Created e um objeto mobileThreatDefenseConnector no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

HTTP

POST https://graph.microsoft.com/v1.0/deviceManagement/mobileThreatDefenseConnectors
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.PostAsync(requestBody);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

CLI

// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc device-management mobile-threat-defense-connectors create --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 obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Ir

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.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) 

mobileThreatDefenseConnectors, err := graphClient.DeviceManagement().MobileThreatDefenseConnectors().Post(context.Background(), requestBody, nil)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do 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().post(mobileThreatDefenseConnector);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do 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')
	.post(mobileThreatDefenseConnector);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PHP

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


$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()->post($requestBody)->wait();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do 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
}

New-MgDeviceManagementMobileThreatDefenseConnector -BodyParameter $params

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Python

from msgraph import GraphServiceClient
from msgraph.generated.models.mobile_threat_defense_connector import MobileThreatDefenseConnector

graph_client = GraphServiceClient(credentials, scopes)

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.post(request_body)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
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
}