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.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government 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 para Dispositivos Móveis
partnerState	mobileThreatPartnerTenantState	Estado do parceiro de Defesa Contra Ameaças para Dispositivos Móveis para esta conta. Os valores possíveis são: unavailable, available, enabled, unresponsive.
androidMobileApplicationManagementEnabled	Booliano	Quando VERDADEIRO, inidica que os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis podem ser utilizados durante avaliações de Gestão de Aplicações Móveis (MAM) para dispositivos Android. Quando FALSO, inidica que os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis não devem ser utilizados durante avaliações de Gestão de Aplicações Móveis (MAM) para dispositivos Android. Apenas um parceiro por plataforma pode ser ativado para avaliação da Gestão de Aplicações Móveis (MAM). O valor predefinido é FALSO.
iosMobileApplicationManagementEnabled	Booliano	Quando VERDADEIRO, inidica que os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis podem ser utilizados durante avaliações de Gestão de Aplicações Móveis (MAM) para dispositivos IOS. Quando falso, inidica que os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis não devem ser utilizados durante avaliações de Gestão de Aplicações Móveis (MAM) para dispositivos IOS. Apenas um parceiro por plataforma pode ser ativado para avaliação da Gestão de Aplicações Móveis (MAM). O valor predefinido é FALSO.
androidEnabled	Booliano	Para Android, defina se os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis devem ser utilizados durante avaliações de conformidade
iosEnabled	Booliano	Para iOS, obtenha ou defina se os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis devem ser utilizados durante avaliações de conformidade
windowsEnabled	Booliano	Quando VERDADEIRO, inidica que os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis podem ser utilizados durante avaliações de conformidade para Windows. Quando FALSO, inidica que os dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis não devem ser utilizados durante as avaliações de conformidade do Windows. O valor predefinido é FALSO.
androidDeviceBlockedOnMissingPartnerData	Booliano	Para Android, defina se Intune têm de receber dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis antes de marcar um dispositivo conforme
iosDeviceBlockedOnMissingPartnerData	Booliano	Para iOS, defina se Intune têm de receber dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis antes de marcar um dispositivo conforme
windowsDeviceBlockedOnMissingPartnerData	Booliano	Quando VERDADEIRO, inidica que Intune têm de receber dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis antes de marcar um dispositivo compatível com o Windows. Quando FALSO, inidica esse Intune pode tornar um dispositivo compatível sem receber dados do parceiro de Defesa Contra Ameaças para Dispositivos Móveis para Windows. O valor predefinido é FALSO.
partnerUnsupportedOsVersionBlocked	Booliano	Obter ou definir se pretende bloquear dispositivos nas plataformas ativadas que não cumprem os requisitos mínimos de versão do parceiro de Defesa Contra Ameaças para Dispositivos 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 VERDADEIRO, indica que o parceiro de Defesa Contra Ameaças para Dispositivos Móveis pode recolher metadados sobre aplicações instaladas a partir de Intune para dispositivos IOS. Quando FALSO, indica que o parceiro de Defesa Contra Ameaças para Dispositivos Móveis pode não recolher metadados sobre aplicações instaladas a partir de Intune para dispositivos IOS. O valor predefinido é FALSO.
allowPartnerToCollectIOSPersonalApplicationMetadata	Booliano	Quando VERDADEIRO, indica que o parceiro de Defesa Contra Ameaças para Dispositivos Móveis pode recolher metadados sobre aplicações instaladas pessoalmente a partir de Intune para dispositivos IOS. Quando FALSO, indica que o parceiro de Defesa Contra Ameaças para Dispositivos Móveis pode não recolher metadados sobre aplicações instaladas pessoalmente a partir de Intune para dispositivos IOS. O valor predefinido é FALSO.
microsoftDefenderForEndpointAttachEnabled	Booliano	Quando VERDADEIRO, inidica essa gestão de perfis de configuração através de Microsoft Defender para Ponto de Extremidade está ativada. Quando FALSO, inidica essa gestão de perfis de configuração através de Microsoft Defender para Ponto de Extremidade é desativada. O valor predefinido é FALSO.

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

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

// 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().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;
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()->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

# 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.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
}