Criar detectedApp

Namespace: microsoft.graph

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

Criar um novo objeto detectedApp.

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)	DeviceManagementManagedDevices.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/detectedApps

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

A tabela a seguir mostra as propriedades que são necessárias ao criar detectedApp.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	O identificador exclusivo do aplicativo detectado. Ele é gerado automaticamente pelo Intune no momento em que o aplicativo é criado. Somente leitura.
displayName	Cadeia de caracteres	Nome do aplicativo descoberto. Somente leitura
version	Cadeia de caracteres	Versão do aplicativo descoberto. Somente leitura
sizeInByte	Int64	Tamanho do aplicativo descoberto, em bytes. Somente leitura
deviceCount	Int32	O número de dispositivos que instalaram esse aplicativo
publicador	Cadeia de caracteres	Indica o editor do aplicativo descoberto. Por exemplo: 'Microsoft'. O valor padrão é uma cadeia de caracteres vazia.
plataforma	detectedAppPlatformType	Indica o sistema operacional/plataforma do aplicativo descoberto. Alguns valores possíveis são Windows, iOS, macOS. O valor padrão é desconhecido (0). Os valores possíveis são: unknown, windows, windowsMobile, windowsHolographic, ios, macOS, chromeOS, androidOSP, androidDeviceAdministrator, androidWorkProfile, androidDedicatedAndFullyManaged, unknownFutureValue.

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

HTTP

POST https://graph.microsoft.com/v1.0/deviceManagement/detectedApps
Content-type: application/json
Content-length: 228

{
  "@odata.type": "#microsoft.graph.detectedApp",
  "displayName": "Display Name value",
  "version": "Version value",
  "sizeInByte": 10,
  "deviceCount": 11,
  "publisher": "Publisher value",
  "platform": "windows"
}

C#

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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new DetectedApp
{
	OdataType = "#microsoft.graph.detectedApp",
	DisplayName = "Display Name value",
	Version = "Version value",
	SizeInByte = 10L,
	DeviceCount = 11,
	Publisher = "Publisher value",
	Platform = DetectedAppPlatformType.Windows,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DetectedApps.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 detected-apps create --body '{\
  "@odata.type": "#microsoft.graph.detectedApp",\
  "displayName": "Display Name value",\
  "version": "Version value",\
  "sizeInByte": 10,\
  "deviceCount": 11,\
  "publisher": "Publisher value",\
  "platform": "windows"\
}\
'

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"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewDetectedApp()
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
version := "Version value"
requestBody.SetVersion(&version) 
sizeInByte := int64(10)
requestBody.SetSizeInByte(&sizeInByte) 
deviceCount := int32(11)
requestBody.SetDeviceCount(&deviceCount) 
publisher := "Publisher value"
requestBody.SetPublisher(&publisher) 
platform := graphmodels.WINDOWS_DETECTEDAPPPLATFORMTYPE 
requestBody.SetPlatform(&platform) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
detectedApps, err := graphClient.DeviceManagement().DetectedApps().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);

DetectedApp detectedApp = new DetectedApp();
detectedApp.setOdataType("#microsoft.graph.detectedApp");
detectedApp.setDisplayName("Display Name value");
detectedApp.setVersion("Version value");
detectedApp.setSizeInByte(10L);
detectedApp.setDeviceCount(11);
detectedApp.setPublisher("Publisher value");
detectedApp.setPlatform(DetectedAppPlatformType.Windows);
DetectedApp result = graphClient.deviceManagement().detectedApps().post(detectedApp);

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 detectedApp = {
  '@odata.type': '#microsoft.graph.detectedApp',
  displayName: 'Display Name value',
  version: 'Version value',
  sizeInByte: 10,
  deviceCount: 11,
  publisher: 'Publisher value',
  platform: 'windows'
};

await client.api('/deviceManagement/detectedApps')
	.post(detectedApp);

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\DetectedApp;
use Microsoft\Graph\Generated\Models\Platform;


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

$requestBody = new DetectedApp();
$requestBody->setOdataType('#microsoft.graph.detectedApp');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion('Version value');
$requestBody->setSizeInByte(10);
$requestBody->setDeviceCount(11);
$requestBody->setPublisher('Publisher value');
$requestBody->setPlatform(new DetectedAppPlatformType('windows'));

$result = $graphServiceClient->deviceManagement()->detectedApps()->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

$params = @{
	"@odata.type" = "#microsoft.graph.detectedApp"
	displayName = "Display Name value"
	version = "Version value"
	sizeInByte = 10
	deviceCount = 11
	publisher = "Publisher value"
	platform = "windows"
}

New-MgDeviceManagementDetectedApp -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.detected_app import DetectedApp
from msgraph.generated.models.detected_app_platform_type import DetectedAppPlatformType

graph_client = GraphServiceClient(credentials, scopes)

request_body = DetectedApp(
	odata_type = "#microsoft.graph.detectedApp",
	display_name = "Display Name value",
	version = "Version value",
	size_in_byte = 10,
	device_count = 11,
	publisher = "Publisher value",
	platform = DetectedAppPlatformType.Windows,
)

result = await graph_client.device_management.detected_apps.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: 277

{
  "@odata.type": "#microsoft.graph.detectedApp",
  "id": "caf60db6-0db6-caf6-b60d-f6cab60df6ca",
  "displayName": "Display Name value",
  "version": "Version value",
  "sizeInByte": 10,
  "deviceCount": 11,
  "publisher": "Publisher value",
  "platform": "windows"
}