Skip to content

Commit 26eb97d

Browse files
DanipocketDanipocket
authored
Merge pull request #28811 from microsoftgraph/Danipocket-patch-3
Update cloudpcprovisioningpolicy.md
2 parents 968a12e + 7c9d7de commit 26eb97d

4 files changed

Lines changed: 20 additions & 12 deletions

File tree

‎api-reference/beta/resources/cloudpc.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: "cloudPC resource type"
33
description: "Represents a cloud-managed virtual desktop."
4-
author: "AshleyYangSZ"
4+
author: "danipocket"
55
ms.localizationpriority: medium
66
ms.subservice: "cloud-pc"
77
doc_type: resourcePageType
8-
ms.date: 11/19/2024
8+
ms.date: 05/05/2026
99
---
1010

1111
# cloudPC resource type
@@ -49,7 +49,8 @@ Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
4949
|[Retrieve snapshots](../api/cloudpc-retrievesnapshots.md)|[cloudPcSnapshot](../resources/cloudpcsnapshot.md) collection|Get a list of [cloudPcSnapshot](../resources/cloudpcsnapshot.md) resources for a Cloud PC.|
5050
|[Get frontline access state](../api/cloudpc-getfrontlinecloudpcaccessstate.md)|[frontlineCloudPcAccessState](#frontlinecloudpcaccessstate-values)|Get the access state of the frontline Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`. The `noLicensesAvailable` member is deprecated and stopped returning on September 30, 2024.|
5151
|[Get launch info (deprecated)](../api/cloudpc-getcloudpclaunchinfo.md)|[cloudPcLaunchInfo](../resources/cloudpclaunchinfo.md)|Get the [cloudPCLaunchInfo](../resources/cloudpclaunchinfo.md) for a specific Cloud PC that belongs to the current signed-in user. This API is deprecated and will stop returning data on October 30, 2026. Going forward, use the [Retrieve launch detail](../api/cloudpc-retrievecloudpclaunchdetail.md) API.|
52-
|[Retrieve frontline Cloud PC detail](../api/cloudpc-retrievefrontlinecloudpcdetail.md)|[frontlineCloudPcDetail](../resources/frontlinecloudpcdetail.md)|Get the [frontlineCloudPcDetail](../resources/frontlinecloudpcdetail.md) of a frontline [Cloud PC](../resources/cloudpc.md).
52+
|[Retrieve frontline Cloud PC detail](../api/cloudpc-retrievefrontlinecloudpcdetail.md)|[frontlineCloudPcDetail](../resources/frontlinecloudpcdetail.md)|Get the [frontlineCloudPcDetail](../resources/frontlinecloudpcdetail.md) of a frontline [Cloud PC](../resources/cloudpc.md).|
53+
5354
## Properties
5455

5556
|Property|Type|Description|
@@ -79,6 +80,7 @@ Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
7980
|provisioningPolicyId|String|The provisioning policy ID of the Cloud PC.|
8081
|provisioningPolicyName|String|The provisioning policy that is applied during the provisioning of Cloud PCs.|
8182
|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|The type of licenses to be used when provisioning Cloud PCs using this policy. The possible values are: `dedicated`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`, `reserve`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`, `reserve`. The default value is `dedicated`. The `shared` member is deprecated and will stop returning on April 30, 2027; going forward, use the `sharedByUser` member. |
83+
|scopeIds|String collection|The scope IDs of the corresponding permission. Currently, it's the Intune scope tag ID. Read-only.|
8284
|servicePlanId|String|The service plan ID of the Cloud PC.|
8385
|servicePlanName|String|The service plan name of the Cloud PC.|
8486
|servicePlanType|[cloudPcServicePlanType](../resources/cloudpcserviceplan.md#cloudpcserviceplantype-values)|The service plan type of the Cloud PC.|
@@ -204,6 +206,7 @@ The following JSON representation shows the resource type.
204206
"servicePlanId": "String",
205207
"servicePlanName": "String",
206208
"servicePlanType": "String",
209+
"scopeIds": ["String"],
207210
"sharedDeviceDetail": {"@odata.type": "microsoft.graph.cloudPcFrontlineSharedDeviceDetail"},
208211
"status": "String",
209212
"userAccountType": "String",

‎api-reference/beta/resources/cloudpcdeviceimage.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: "cloudPcDeviceImage resource type"
33
description: "Represents the image resource on Cloud PC."
4-
author: "AshleyYangSZ"
4+
author: "danipocket"
55
ms.localizationpriority: medium
66
ms.subservice: "cloud-pc"
77
doc_type: resourcePageType
8-
ms.date: 09/27/2024
8+
ms.date: 05/05/2026
99
---
1010

1111
# cloudPcDeviceImage resource type
@@ -41,6 +41,7 @@ Represents the image resource on a Cloud PC.
4141
|osBuildNumber|String|The OS build version of the image. For example, `1909`. Read-only.|
4242
|osStatus|[cloudPcDeviceImageOsStatus](#cloudpcdeviceimageosstatus-values)|The OS status of this image. The possible values are: `supported`, `supportedWithWarning`, `unknown`, `unknownFutureValue`. The default value is `unknown`. Read-only.|
4343
|osVersionNumber|String|The operating system version of this image. For example, `10.0.22000.296`. Read-only.|
44+
|scopeIds|String collection|The scope IDs of the corresponding permission. Currently, it's the Intune scope tag ID. Read-only.|
4445
|sizeInGB|Int32|The size of the image in GB. For example, `64`. Read-only.|
4546
|sourceImageResourceId|String|The unique identifier (ID) of the source image resource on Azure. The required ID format is: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Read-only.|
4647
|status|[cloudPcDeviceImageStatus](#cloudpcdeviceimagestatus-values)|The status of the image on the Cloud PC. The possible values are: `pending`, `ready`, `warning`, `failed`, `unknownFutureValue`. Read-only.|
@@ -129,6 +130,7 @@ The following JSON representation shows the resource type.
129130
"osBuildNumber": "String",
130131
"osStatus": "String",
131132
"osVersionNumber": "String",
133+
"scopeIds": ["String"],
132134
"sizeInGB": "Int32",
133135
"sourceImageResourceId": "String",
134136
"status": "String",

‎api-reference/beta/resources/cloudpconpremisesconnection.md‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: "cloudPcOnPremisesConnection resource type"
33
description: "Represents a defined collection of Azure resource information that can be used to establish Azure network connectivity for Cloud PCs."
4-
author: "AshleyYangSZ"
4+
author: "danipocket"
55
ms.localizationpriority: medium
66
ms.subservice: "cloud-pc"
77
doc_type: resourcePageType
88
toc.title: Cloud PC Azure network connection
9-
ms.date: 10/21/2024
9+
ms.date: 05/05/2026
1010
---
1111

1212
# cloudPcOnPremisesConnection resource type
@@ -50,7 +50,6 @@ Represents a defined collection of Azure resource information that can be used t
5050
|inUseByCloudPc|Boolean| Indicates whether a Cloud PC is using this on-premises network connection. `true` if at least one Cloud PC is using it. Otherwise, `false`. Read-only. Default is `false`. |
5151
|managedBy|[cloudPcManagementService](#cloudpcmanagementservice-values)|Specifies which services manage the Azure network connection. The possible values are: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`, `microsoft365Opal`, `microsoft365BizChat`. Use the `Prefer: include-unknown-enum-members` request header to get the following members in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `rpaBox`, `microsoft365Opal`, `microsoft365BizChat`. Read-only.|
5252
|organizationalUnit|String|The organizational unit (OU) in which the computer account is created. If left null, the OU configured as the default (a well-known computer object container) in your Active Directory domain (OU) is used. Optional.|
53-
|organizationalUnit|String|The organizational unit (OU) in which the computer account is created. If left null, the OU configured as the default (a well-known computer object container) in your Active Directory domain (OU) is used. Optional.|
5453
|resourceGroupId|String|The ID of the target resource group. Required format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}`.|
5554
|scopeIds|String collection|The scope IDs of the corresponding permission. Currently, it's the Intune scope tag ID.|
5655
|subnetId|String|The ID of the target subnet. Required format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}`.|
@@ -73,7 +72,6 @@ Represents a defined collection of Azure resource information that can be used t
7372
| microsoft365Opal | Indicates that the Cloud PC Azure network connection was successfully created through the Project Opal. |
7473
| microsoft365BizChat| Indicates that the Cloud PC Azure network connection was successfully created through the Project Biz Chat.|
7574

76-
7775
### cloudPcOnPremisesConnectionType values
7876

7977
|Member|Description|

‎api-reference/beta/resources/cloudpcprovisioningpolicy.md‎

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: "cloudPcProvisioningPolicy resource type"
33
description: "Represents a Cloud PC provisioning policy."
4-
author: "AshleyYangSZ"
4+
author: "danipocket"
55
ms.localizationpriority: medium
66
ms.subservice: "cloud-pc"
77
doc_type: resourcePageType
8-
ms.date: 09/25/2024
8+
ms.date: 05/05/2026
99
---
1010

1111
# cloudPcProvisioningPolicy resource type
@@ -29,6 +29,9 @@ Represents a Cloud PC provisioning policy.
2929
|[Apply](../api/cloudpcprovisioningpolicy-apply.md)|None|Apply the current [provisioning policy](../resources/cloudpcprovisioningpolicy.md) configuration to all Cloud PC devices under a specified policy. Currently, you can only change the region.|
3030
|[Apply configuration](../api/cloudpcprovisioningpolicy-applyconfig.md)|None|Update the [provisioning policy](../resources/cloudpcprovisioningpolicy.md) configuration for a set of Cloud PC devices by their IDs.|
3131
|[Retry](../api/cloudpcprovisioningpolicy-retry.md)|None| Retry the provisioning operation for Cloud PCs that used the current frontline shared policy and failed to apply the [provisioning policy](../resources/cloudpcprovisioningpolicy.md).|
32+
|[Schedule policy apply task](../api/cloudpcprovisioningpolicy-schedulepolicyapplytask.md)|None|Schedule a policy apply task for a [provisioning policy](../resources/cloudpcprovisioningpolicy.md).|
33+
|[Retrieve policy apply action result](../api/cloudpcprovisioningpolicy-retrievepolicyapplyactionresult.md)|[cloudPcPolicyApplyActionResult](../resources/cloudpcpolicyapplyactionresult.md)|Retrieve the result of a policy apply action for a [provisioning policy](../resources/cloudpcprovisioningpolicy.md).|
34+
|[Retrieve policy apply schedule](../api/cloudpcprovisioningpolicy-retrievepolicyapplyschedule.md)|[cloudPcPolicyScheduledApplyActionDetail](../resources/cloudpcpolicyscheduledapplyactiondetail.md)|Retrieve the schedule for a policy apply action for a [provisioning policy](../resources/cloudpcprovisioningpolicy.md).|
3235

3336
## Properties
3437

@@ -56,9 +59,10 @@ Represents a Cloud PC provisioning policy.
5659
|managedBy|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|Indicates the service that manages the provisioning policy. The possible values are: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`, `microsoft365Opal`, `microsoft365BizChat`. The default value is `windows365`. Use the `Prefer: include-unknown-enum-members` request header to get the following members in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `rpaBox`. Supports `$filter`, `$select`, and `$orderBy`.|
5760
|microsoftManagedDesktop|[microsoftManagedDesktop](../resources/microsoftmanageddesktop.md)|The specific settings to **microsoftManagedDesktop** that enables Microsoft Managed Desktop customers to get device managed experience for Cloud PC. To enable **microsoftManagedDesktop** to provide more value, an admin needs to specify certain settings in it. Supports `$filter`, `$select`, and `$orderBy`.|
5861
|provisioningType|[cloudPcProvisioningType](../resources/cloudpcprovisioningpolicy.md#cloudpcprovisioningtype-values)|Specifies the type of licenses to be used when provisioning Cloud PCs using this policy. The possible values are `dedicated`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`, `reserve`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `sharedByUser`, `sharedByEntraGroup`, `reserve`. The `shared` member is deprecated and will stop returning on April 30, 2027; going forward, use the `sharedByUser` member. For example, a `dedicated` service plan can be assigned to only one user and provision only one Cloud PC. The `shared` and `sharedByUser` plans require customers to purchase a shared service plan. Each shared license purchased can enable up to three Cloud PCs, with only one user signed in at a time. The `sharedByEntraGroup` plan also requires the purchase of a shared service plan. Each shared license under this plan can enable one Cloud PC, which is shared for the group according to the assignments of this policy. By default, the license type is `dedicated` if the **provisioningType** isn't specified when you create the **cloudPcProvisioningPolicy**. You can't change this property after the **cloudPcProvisioningPolicy** is created.|
62+
|scopeIds|String collection|The list of scope tag IDs for this resource. Read-only.|
5963
|userExperienceType|[cloudPcUserExperienceType](../resources/cloudpcprovisioningpolicy.md#cloudpcuserexperiencetype-values)|Specifies the type of cloud object the end user can access. The possible values are: `cloudPc`, `cloudApp`, `unknownFutureValue`. `cloudPc` indicates that the end user can access the entire desktop. `cloudApp` indicates that the end user can only access apps published under this provisioning policy. The type can't be changed once the provisioning policy is created. If not specified during creation, the default value is `cloudPc`. When `cloudApp` is selected, the **provisioningType** must be `sharedByEntraGroup`. Supports `$filter`, `$select`, `$orderBy`.|
60-
|windowsSetting|[cloudPcWindowsSettings](../resources/cloudpcwindowssetting.md)|Indicates a specific Windows setting to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. |
6164
|userSettingsPersistenceConfiguration|[cloudPcUserSettingsPersistenceConfiguration](../resources/cloudpcusersettingspersistenceconfiguration.md)|Indicates specific settings that enable the persistence of user application settings between Cloud PC sessions. The default value is `null`. This feature is only available for Cloud PC provisioning policies of type `sharedByEntraGroup`. Supports `$select`. |
65+
|windowsSetting|[cloudPcWindowsSettings](../resources/cloudpcwindowssetting.md)|Indicates a specific Windows setting to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. |
6266
|domainJoinConfiguration (deprecated)|[cloudPcDomainJoinConfiguration](../resources/cloudpcdomainjoinconfiguration.md)|Specifies how Cloud PCs join Microsoft Entra ID. The **domainJoinConfiguration** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.|
6367
|onPremisesConnectionId (deprecated)|String|The ID of the [cloudPcOnPremisesConnection](../resources/cloudpconpremisesconnection.md). To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network that the Cloud PC service validated it. The **onPremisesConnectionId** property is deprecated and will stop returning data on May 31, 2024. Going forward, use the **domainJoinConfigurations** property.|
6468
|windowsSettings (deprecated)|[cloudPcWindowsSettings](../resources/cloudpcwindowssettings.md)|Specific Windows settings to configure during the creation of Cloud PCs for this provisioning policy. Supports `$select`. The **windowsSettings** property is deprecated and will stop returning data on January 31, 2024. Going forward, use the **windowsSetting** property.|
@@ -129,6 +133,7 @@ The following JSON representation shows the resource type.
129133
"microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
130134
"onPremisesConnectionId": "String",
131135
"provisioningType": "String",
136+
"scopeIds": ["String"],
132137
"userExperienceType": "String",
133138
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
134139
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},

0 commit comments

Comments
 (0)