Создание cloudPcCloudApp

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Создайте объект cloudPcCloudApp .

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

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

Разрешения

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

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

HTTP-запрос

POST /deviceManagement/virtualEndpoint/cloudApps

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

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

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

В тексте запроса укажите представление объекта cloudPcCloudApp в формате JSON.

В следующей таблице показаны свойства, доступные при создании cloudPcCloudApp.

Свойство	Тип	Описание
appDetail	cloudPcCloudAppDetail	Сведения об облачном приложении. Это полиморфный тип. Используйте @odata.type , чтобы указать производный тип: `#microsoft.graph.cloudPcFilePathAppDetail` для приложений с указанным вручную путем к файлу или `#microsoft.graph.cloudPcAutomaticDiscoveredAppDetail` для автоматически обнаруженных приложений. Обязательный.
description	String	Описание, связанное с облачным приложением. Максимальная допустимая длина для этого свойства составляет 512 символов. Необязательный параметр.
discoveredAppName	String	Имя обнаруженного приложения, связанного с облачным приложением. Обязательно.
displayName	String	Отображаемое имя облачного приложения. Должен быть уникальным в рамках одной политики подготовки. Максимальная допустимая длина для этого свойства составляет 64 символа. Обязательно.
provisioningPolicyId	String	Идентификатор политики подготовки, связанной с этим облачным приложением. Обязательно.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект cloudPcCloudApp в тексте ответа.

Примеры

Запрос

В следующем примере показано, как создать облачное приложение с помощью типа cloudPcFilePathAppDetail .

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudApps
Content-Type: application/json

{
  "displayName": "Remote Desktop Connection",
  "discoveredAppName": "Remote Desktop Connection",
  "provisioningPolicyId": "e31f75e9-25a8-41e9-a9d5-ce8fd484af15",
  "description": "",
  "appDetail": {
    "@odata.type": "#microsoft.graph.cloudPcFilePathAppDetail",
    "filePath": "C:\\Windows\\system32\\mstsc.exe",
    "commandLineArguments": "",
    "iconPath": "C:\\Windows\\system32\\mstsc.exe",
    "iconIndex": 0
  }
}


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

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new CloudPcCloudApp
{
	DisplayName = "Remote Desktop Connection",
	DiscoveredAppName = "Remote Desktop Connection",
	ProvisioningPolicyId = "e31f75e9-25a8-41e9-a9d5-ce8fd484af15",
	Description = "",
	AppDetail = new CloudPcFilePathAppDetail
	{
		OdataType = "#microsoft.graph.cloudPcFilePathAppDetail",
		FilePath = "C:\Windows\system32\mstsc.exe",
		CommandLineArguments = "",
		IconPath = "C:\Windows\system32\mstsc.exe",
		IconIndex = 0,
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.VirtualEndpoint.CloudApps.PostAsync(requestBody);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

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



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

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

requestBody := graphmodels.NewCloudPcCloudApp()
displayName := "Remote Desktop Connection"
requestBody.SetDisplayName(&displayName) 
discoveredAppName := "Remote Desktop Connection"
requestBody.SetDiscoveredAppName(&discoveredAppName) 
provisioningPolicyId := "e31f75e9-25a8-41e9-a9d5-ce8fd484af15"
requestBody.SetProvisioningPolicyId(&provisioningPolicyId) 
description := ""
requestBody.SetDescription(&description) 
appDetail := graphmodels.NewCloudPcFilePathAppDetail()
filePath := "C:\Windows\system32\mstsc.exe"
appDetail.SetFilePath(&filePath) 
commandLineArguments := ""
appDetail.SetCommandLineArguments(&commandLineArguments) 
iconPath := "C:\Windows\system32\mstsc.exe"
appDetail.SetIconPath(&iconPath) 
iconIndex := int32(0)
appDetail.SetIconIndex(&iconIndex) 
requestBody.SetAppDetail(appDetail)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
cloudApps, err := graphClient.DeviceManagement().VirtualEndpoint().CloudApps().Post(context.Background(), requestBody, nil)

Важно!

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


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

CloudPcCloudApp cloudPcCloudApp = new CloudPcCloudApp();
cloudPcCloudApp.setDisplayName("Remote Desktop Connection");
cloudPcCloudApp.setDiscoveredAppName("Remote Desktop Connection");
cloudPcCloudApp.setProvisioningPolicyId("e31f75e9-25a8-41e9-a9d5-ce8fd484af15");
cloudPcCloudApp.setDescription("");
CloudPcFilePathAppDetail appDetail = new CloudPcFilePathAppDetail();
appDetail.setOdataType("#microsoft.graph.cloudPcFilePathAppDetail");
appDetail.setFilePath("C:\Windows\system32\mstsc.exe");
appDetail.setCommandLineArguments("");
appDetail.setIconPath("C:\Windows\system32\mstsc.exe");
appDetail.setIconIndex(0);
cloudPcCloudApp.setAppDetail(appDetail);
CloudPcCloudApp result = graphClient.deviceManagement().virtualEndpoint().cloudApps().post(cloudPcCloudApp);

Важно!

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


const options = {
	authProvider,
};

const client = Client.init(options);

const cloudPcCloudApp = {
  displayName: 'Remote Desktop Connection',
  discoveredAppName: 'Remote Desktop Connection',
  provisioningPolicyId: 'e31f75e9-25a8-41e9-a9d5-ce8fd484af15',
  description: '',
  appDetail: {
    '@odata.type': '#microsoft.graph.cloudPcFilePathAppDetail',
    filePath: 'C:\\Windows\\system32\\mstsc.exe',
    commandLineArguments: '',
    iconPath: 'C:\\Windows\\system32\\mstsc.exe',
    iconIndex: 0
  }
};

await client.api('/deviceManagement/virtualEndpoint/cloudApps')
	.version('beta')
	.post(cloudPcCloudApp);

Важно!

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


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\CloudPcCloudApp;
use Microsoft\Graph\Beta\Generated\Models\CloudPcFilePathAppDetail;


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

$requestBody = new CloudPcCloudApp();
$requestBody->setDisplayName('Remote Desktop Connection');
$requestBody->setDiscoveredAppName('Remote Desktop Connection');
$requestBody->setProvisioningPolicyId('e31f75e9-25a8-41e9-a9d5-ce8fd484af15');
$requestBody->setDescription('');
$appDetail = new CloudPcFilePathAppDetail();
$appDetail->setOdataType('#microsoft.graph.cloudPcFilePathAppDetail');
$appDetail->setFilePath('C:\Windows\system32\mstsc.exe');
$appDetail->setCommandLineArguments('');
$appDetail->setIconPath('C:\Windows\system32\mstsc.exe');
$appDetail->setIconIndex(0);
$requestBody->setAppDetail($appDetail);

$result = $graphServiceClient->deviceManagement()->virtualEndpoint()->cloudApps()->post($requestBody)->wait();

Важно!

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


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.cloud_pc_cloud_app import CloudPcCloudApp
from msgraph_beta.generated.models.cloud_pc_file_path_app_detail import CloudPcFilePathAppDetail
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CloudPcCloudApp(
	display_name = "Remote Desktop Connection",
	discovered_app_name = "Remote Desktop Connection",
	provisioning_policy_id = "e31f75e9-25a8-41e9-a9d5-ce8fd484af15",
	description = "",
	app_detail = CloudPcFilePathAppDetail(
		odata_type = "#microsoft.graph.cloudPcFilePathAppDetail",
		file_path = "C:\Windows\system32\mstsc.exe",
		command_line_arguments = "",
		icon_path = "C:\Windows\system32\mstsc.exe",
		icon_index = 0,
	),
)

result = await graph_client.device_management.virtual_endpoint.cloud_apps.post(request_body)

Важно!

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

Отклик

Ниже показан пример отклика.

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/virtualEndpoint/cloudApps/$entity",
  "id": "60a7bbf2-d831-4dc8-8375-1253403f7e74",
  "displayName": "Remote Desktop Connection",
  "discoveredAppName": "Remote Desktop Connection",
  "provisioningPolicyId": "e31f75e9-25a8-41e9-a9d5-ce8fd484af15",
  "description": "",
  "appDetail": {
    "@odata.type": "#microsoft.graph.cloudPcFilePathAppDetail",
    "filePath": "C:\\Windows\\system32\\mstsc.exe",
    "commandLineArguments": "",
    "iconPath": "C:\\Windows\\system32\\mstsc.exe",
    "iconIndex": 0
  },
  "addedDateTime": "2025-11-13T07:37:22.3049326Z",
  "lastPublishedDateTime": "0001-01-01T00:00:00Z",
  "appStatus": "preparing",
  "actionFailedErrorCode": null,
  "actionFailedErrorMessage": null,
  "availableToUser": false,
  "scopeIds": [
    "0"
  ]
}

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-05-28

Создание cloudPcCloudApp

Разрешения

HTTP-запрос

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

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

Отклик

Примеры

Запрос

Отклик

Обратная связь

Дополнительные ресурсы