Действие targetApps

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Пока не задокументировано.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementApps.ReadWrite.All

HTTP-запрос

POST /deviceAppManagement/managedAppPolicies/{managedAppPolicyId}/targetApps
POST /deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/appliedPolicies/{managedAppPolicyId}/targetApps
POST /deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/intendedPolicies/{managedAppPolicyId}/targetApps

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тело запроса добавьте параметры в формате JSON.

В приведенной ниже таблице указаны параметры, которые можно использовать с этим действием.

Свойство	Тип	Описание
apps	Коллекция managedMobileApp	Пока нет описания

Ответ

В случае успешного выполнения это действие возвращает код отклика 204 No Content.

Пример

Запрос

Ниже приведен пример запроса.

HTTP

POST https://graph.microsoft.com/v1.0/deviceAppManagement/managedAppPolicies/{managedAppPolicyId}/targetApps
Content-type: application/json
Content-length: 335

{
  "apps": [
    {
      "@odata.type": "#microsoft.graph.managedMobileApp",
      "mobileAppIdentifier": {
        "@odata.type": "microsoft.graph.androidMobileAppIdentifier",
        "packageId": "Package Id value"
      },
      "id": "0a129715-9715-0a12-1597-120a1597120a",
      "version": "Version value"
    }
  ]
}

C#

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

// Dependencies
using Microsoft.Graph.DeviceAppManagement.ManagedAppPolicies.Item.TargetApps;
using Microsoft.Graph.Models;

var requestBody = new TargetAppsPostRequestBody
{
	Apps = new List<ManagedMobileApp>
	{
		new ManagedMobileApp
		{
			OdataType = "#microsoft.graph.managedMobileApp",
			MobileAppIdentifier = new AndroidMobileAppIdentifier
			{
				OdataType = "microsoft.graph.androidMobileAppIdentifier",
				PackageId = "Package Id value",
			},
			Id = "0a129715-9715-0a12-1597-120a1597120a",
			Version = "Version value",
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.DeviceAppManagement.ManagedAppPolicies["{managedAppPolicy-id}"].TargetApps.PostAsync(requestBody);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

CLI

mgc device-app-management managed-app-policies target-apps post --managed-app-policy-id {managedAppPolicy-id} --body '{\
  "apps": [\
    {\
      "@odata.type": "#microsoft.graph.managedMobileApp",\
      "mobileAppIdentifier": {\
        "@odata.type": "microsoft.graph.androidMobileAppIdentifier",\
        "packageId": "Package Id value"\
      },\
      "id": "0a129715-9715-0a12-1597-120a1597120a",\
      "version": "Version value"\
    }\
  ]\
}\
'

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Go

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

requestBody := graphdeviceappmanagement.NewTargetAppsPostRequestBody()


managedMobileApp := graphmodels.NewManagedMobileApp()
mobileAppIdentifier := graphmodels.NewAndroidMobileAppIdentifier()
packageId := "Package Id value"
mobileAppIdentifier.SetPackageId(&packageId) 
managedMobileApp.SetMobileAppIdentifier(mobileAppIdentifier)
id := "0a129715-9715-0a12-1597-120a1597120a"
managedMobileApp.SetId(&id) 
version := "Version value"
managedMobileApp.SetVersion(&version) 

apps := []graphmodels.ManagedMobileAppable {
	managedMobileApp,
}
requestBody.SetApps(apps)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.DeviceAppManagement().ManagedAppPolicies().ByManagedAppPolicyId("managedAppPolicy-id").TargetApps().Post(context.Background(), requestBody, nil)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.deviceappmanagement.managedapppolicies.item.targetapps.TargetAppsPostRequestBody targetAppsPostRequestBody = new com.microsoft.graph.deviceappmanagement.managedapppolicies.item.targetapps.TargetAppsPostRequestBody();
LinkedList<ManagedMobileApp> apps = new LinkedList<ManagedMobileApp>();
ManagedMobileApp managedMobileApp = new ManagedMobileApp();
managedMobileApp.setOdataType("#microsoft.graph.managedMobileApp");
AndroidMobileAppIdentifier mobileAppIdentifier = new AndroidMobileAppIdentifier();
mobileAppIdentifier.setOdataType("microsoft.graph.androidMobileAppIdentifier");
mobileAppIdentifier.setPackageId("Package Id value");
managedMobileApp.setMobileAppIdentifier(mobileAppIdentifier);
managedMobileApp.setId("0a129715-9715-0a12-1597-120a1597120a");
managedMobileApp.setVersion("Version value");
apps.add(managedMobileApp);
targetAppsPostRequestBody.setApps(apps);
graphClient.deviceAppManagement().managedAppPolicies().byManagedAppPolicyId("{managedAppPolicy-id}").targetApps().post(targetAppsPostRequestBody);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const targetApps = {
  apps: [
    {
      '@odata.type': '#microsoft.graph.managedMobileApp',
      mobileAppIdentifier: {
        '@odata.type': 'microsoft.graph.androidMobileAppIdentifier',
        packageId: 'Package Id value'
      },
      id: '0a129715-9715-0a12-1597-120a1597120a',
      version: 'Version value'
    }
  ]
};

await client.api('/deviceAppManagement/managedAppPolicies/{managedAppPolicyId}/targetApps')
	.post(targetApps);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\DeviceAppManagement\ManagedAppPolicies\Item\TargetApps\TargetAppsPostRequestBody;
use Microsoft\Graph\Generated\Models\ManagedMobileApp;
use Microsoft\Graph\Generated\Models\AndroidMobileAppIdentifier;


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

$requestBody = new TargetAppsPostRequestBody();
$appsManagedMobileApp1 = new ManagedMobileApp();
$appsManagedMobileApp1->setOdataType('#microsoft.graph.managedMobileApp');
$appsManagedMobileApp1MobileAppIdentifier = new AndroidMobileAppIdentifier();
$appsManagedMobileApp1MobileAppIdentifier->setOdataType('microsoft.graph.androidMobileAppIdentifier');
$appsManagedMobileApp1MobileAppIdentifier->setPackageId('Package Id value');
$appsManagedMobileApp1->setMobileAppIdentifier($appsManagedMobileApp1MobileAppIdentifier);
$appsManagedMobileApp1->setId('0a129715-9715-0a12-1597-120a1597120a');
$appsManagedMobileApp1->setVersion('Version value');
$appsArray []= $appsManagedMobileApp1;
$requestBody->setApps($appsArray);


$graphServiceClient->deviceAppManagement()->managedAppPolicies()->byManagedAppPolicyId('managedAppPolicy-id')->targetApps()->post($requestBody)->wait();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PowerShell

Import-Module Microsoft.Graph.Devices.CorporateManagement

$params = @{
	apps = @(
		@{
			"@odata.type" = "#microsoft.graph.managedMobileApp"
			mobileAppIdentifier = @{
				"@odata.type" = "microsoft.graph.androidMobileAppIdentifier"
				packageId = "Package Id value"
			}
			id = "0a129715-9715-0a12-1597-120a1597120a"
			version = "Version value"
		}
	)
}

Invoke-MgTargetDeviceAppManagementManagedAppPolicyApp -ManagedAppPolicyId $managedAppPolicyId -BodyParameter $params

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.deviceappmanagement.managedapppolicies.item.target_apps.target_apps_post_request_body import TargetAppsPostRequestBody
from msgraph.generated.models.managed_mobile_app import ManagedMobileApp
from msgraph.generated.models.android_mobile_app_identifier import AndroidMobileAppIdentifier
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TargetAppsPostRequestBody(
	apps = [
		ManagedMobileApp(
			odata_type = "#microsoft.graph.managedMobileApp",
			mobile_app_identifier = AndroidMobileAppIdentifier(
				odata_type = "microsoft.graph.androidMobileAppIdentifier",
				package_id = "Package Id value",
			),
			id = "0a129715-9715-0a12-1597-120a1597120a",
			version = "Version value",
		),
	],
)

await graph_client.device_app_management.managed_app_policies.by_managed_app_policy_id('managedAppPolicy-id').target_apps.post(request_body)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 204 No Content