Пространство имен: 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
Текст запроса
В тексте запроса укажите представление объекта 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);
// 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)
// 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);
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);
<?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();
# 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)
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
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"
]
}