| alternateResourceUrl |
String |
The URL of the alternate resource that links to this provisioning policy. Read-only. |
| autopatch |
cloudPcProvisioningPolicyAutopatch |
Indicates the Windows Autopatch settings for Cloud PCs using this provisioning policy. The settings take effect when the tenant enrolls in Autopatch and the managedType of the microsoftManagedDesktop property is set as starterManaged. Supports $select. |
| autopilotConfiguration |
cloudPcAutopilotConfiguration |
The specific settings for Windows Autopilot that enable Windows 365 customers to experience it on Cloud PC. Supports $select. |
| cloudPcGroupDisplayName |
String |
The display name of the Cloud PC group that the Cloud PCs reside in. Read-only. |
| cloudPcNamingTemplate |
String |
The template used to name Cloud PCs provisioned using this policy. The template can contain custom text and replacement tokens, including %USERNAME:x% and %RAND:x%, which represent the user's name and a randomly generated number, respectively. For example, CPC-%USERNAME:4%-%RAND:5% means that the name of the Cloud PC starts with CPC-, followed by a four-character username, a - character, and then five random characters. The total length of the text generated by the template can't exceed 15 characters. Supports $filter, $select, and $orderby. |
| createdBy |
String |
The unique ID of the user who created this policy. For example, 5ccb8d35-dd04-473e-a287-69bb4473208b. Read-only. Supports $select. |
| createdDateTime |
DateTimeOffset |
The timestamp when this provisioning policy was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Supports $select and $orderBy. |
| description |
String |
The provisioning policy description. Supports $filter, $select, and $orderBy. |
| displayName |
String |
The display name for the provisioning policy. |
| domainJoinConfigurations |
cloudPcDomainJoinConfiguration collection |
Specifies a list ordered by priority on how Cloud PCs join Microsoft Entra ID (Azure AD). Supports $select. |
| enableSingleSignOn |
Boolean |
True if single sign-on can access the provisioned Cloud PC. False indicates that the provisioned Cloud PC doesn't support this feature. The default value is false. Windows 365 users can use single sign-on to authenticate to Microsoft Entra ID with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional. |
| gracePeriodInHours |
Int32 |
The number of hours to wait before reprovisioning/deprovisioning happens. Read-only. |
| id |
String |
The unique identifier associated with the provisioning policy. This ID is auto populated during the creation of a new provisioning policy. Read-only. Supports $filter, $select, and $orderBy. |
| imageDisplayName |
String |
The display name of the operating system image that is used for provisioning. For example, Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Supports $filter, $select, and $orderBy. |
| imageId |
String |
The unique identifier that represents an operating system image that is used for provisioning new Cloud PCs. The format for a gallery type image is: {publisherName_offerName_skuName}. Supported values for each of the parameters are:- publisher:
Microsoftwindowsdesktop - offer:
windows-ent-cpc - sku:
21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365, and 19h2-ent-cpc-os Supports $filter, $select, and $orderBy. |
| imageType |
cloudPcProvisioningPolicyImageType |
The type of operating system image (custom or gallery) that is used for provisioning on Cloud PCs. The possible values are: gallery, custom. The default value is gallery. Supports $filter, $select, and $orderBy. |
| lastModifiedBy |
String |
The unique ID of the user who last updated this policy. For example, 5ccb8d35-dd04-473e-a287-69bb4473208b. Read-only. Supports $select. |
| lastModifiedDateTime |
DateTimeOffset |
The timestamp when this provisioning policy was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Supports $select and $orderBy. |
| localAdminEnabled |
Boolean |
When true, the local admin is enabled for Cloud PCs; false indicates that the local admin isn't enabled for Cloud PCs. The default value is false. Supports $filter, $select, and $orderBy. |
| managedBy |
cloudPcManagementService |
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: rpaBox. Supports $filter, $select, and $orderBy. |
| microsoftManagedDesktop |
microsoftManagedDesktop |
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. |
| provisioningType |
cloudPcProvisioningType |
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: 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. |
| userExperienceType |
cloudPcUserExperienceType |
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. |
| windowsSetting |
cloudPcWindowsSettings |
Indicates a specific Windows setting to configure during the creation of Cloud PCs for this provisioning policy. Supports $select. |
| userSettingsPersistenceConfiguration |
cloudPcUserSettingsPersistenceConfiguration |
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. |
| domainJoinConfiguration (deprecated) |
cloudPcDomainJoinConfiguration |
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. |
| onPremisesConnectionId (deprecated) |
String |
The ID of the cloudPcOnPremisesConnection. 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. |
| windowsSettings (deprecated) |
cloudPcWindowsSettings |
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. |