ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

CloudPC.Read.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read All Resources

Allows the app to read the properties of Cloud PCs, without a signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read Cloud PCs

Allows the app to read the properties of Cloud PCs, without a signed-in user.

Permission ID: a9e09520-8ed4-4cde-838e-4fdea192c227
Delegated Permission User consent allowed

Read Cloud PCs

Allows the app to read the properties of Cloud PCs on behalf of the signed-in user.

User sees: Allows the app to read the properties of Cloud PCs, on your behalf.
Permission ID: 5252ec4e-fd40-4d92-8c68-89dd1d3c6110

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
aadDeviceId StringNullable The Microsoft Entra device ID for the Cloud PC, also known as the Azure Active Directory (Azure AD) device ID, that consists of 32 characters in a GUID format. Generated on a VM joined to Microsoft Entra ID. Read-only.
displayName StringNullable The display name for the Cloud PC. Maximum length is 64 characters. Read-only. You can use the cloudPC: rename API to modify the Cloud PC name.
gracePeriodEndDateTime DateTimeOffsetNullable The date and time when the grace period ends and reprovisioning or deprovisioning happen. Required only if the status is inGracePeriod. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
id String The unique identifier of the customer-facing Cloud PC entity that consists of 32 characters in a GUID format. Read-only. Inherited from entity.
imageDisplayName StringNullable The name of the operating system image used for the Cloud PC. Maximum length is 50 characters. Only letters (A-Z, a-z), numbers (0-9), and special characters (-,,.) are allowed for this property. The property value can't begin or end with an underscore. Read-only.
lastModifiedDateTime DateTimeOffset The last modified date and time of the Cloud PC. 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.
managedDeviceId StringNullable The Intune enrolled device ID for the Cloud PC that consists of 32 characters in a GUID format. The managedDeviceId property of Windows 365 Business Cloud PCs is always null as Windows 365 Business Cloud PCs aren't Intune-enrolled automatically by Windows 365. Read-only.
managedDeviceName StringNullable The Intune enrolled device name for the Cloud PC. The managedDeviceName property of Windows 365 Business Cloud PCs is always null as Windows 365 Business Cloud PCs aren't Intune-enrolled automatically by Windows 365. Read-only.
onPremisesConnectionName StringNullable The on-premises connection that applied during the provisioning of Cloud PCs. Read-only.
provisioningPolicyId StringNullable The provisioning policy ID for the Cloud PC that consists of 32 characters in a GUID format. A policy defines the type of Cloud PC the user wants to create. Read-only.
provisioningPolicyName StringNullable The provisioning policy that applied during the provisioning of Cloud PCs. Maximum length is 120 characters. Read-only.
provisioningType cloudPcProvisioningType The type of licenses to be used when provisioning Cloud PCs using this policy. The possible values are: dedicated, shared, unknownFutureValue. The default value is dedicated.
servicePlanId StringNullable The service plan ID for the Cloud PC that consists of 32 characters in a GUID format. For more information about service plans, see Product names and service plan identifiers for licensing. Read-only.
servicePlanName StringNullable The service plan name for the customer-facing Cloud PC entity. Read-only.
userPrincipalName StringNullable The user principal name (UPN) of the user assigned to the Cloud PC. Maximum length is 113 characters. For more information on username policies, see Password policies and account restrictions in Microsoft Entra ID. Read-only.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation 
{
  "@odata.type": "#microsoft.graph.cloudPC",
  "aadDeviceId": "String",
  "displayName": "String",
  "gracePeriodEndDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "managedDeviceId": "String",
  "managedDeviceName": "String",
  "onPremisesConnectionName": "String",
  "provisioningPolicyId": "String",
  "provisioningPolicyName": "String",
  "provisioningType": "String",
  "servicePlanId": "String",
  "servicePlanName": "String",
  "userPrincipalName": "String"
}

Relationships

Microsoft Graph v1.0 exact-category

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
cloudPCs cloudPC collection Cloud PCs in the tenant.
provisioningPolicies cloudPcProvisioningPolicy collection Provisioning policies for Cloud PCs.
partnerAgentInstallResults cloudPcPartnerAgentInstallResult collection The results of every partner agent's installation status on Cloud PC.
scopeIds string collection Related scopeIds data exposed by this resource.
status cloudPcStatus Related status data exposed by this resource.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /deviceManagement/virtualEndpoint/auditEvents
GET /deviceManagement/virtualEndpoint/auditEvents/{id}
GET /deviceManagement/virtualEndpoint/auditEvents/getAuditActivityTypes
GET /deviceManagement/virtualEndpoint/cloudPCs
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}
GET /deviceManagement/virtualEndpoint/deviceImages
GET /deviceManagement/virtualEndpoint/deviceImages/{id}
GET /deviceManagement/virtualEndpoint/deviceImages/getSourceImages
GET /deviceManagement/virtualEndpoint/galleryImages
GET /deviceManagement/virtualEndpoint/galleryImages/{id}
GET /deviceManagement/virtualEndpoint/onPremisesConnections
GET /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
GET /deviceManagement/virtualEndpoint/provisioningPolicies
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
GET /deviceManagement/virtualEndpoint/userSettings
GET /deviceManagement/virtualEndpoint/userSettings/{id}
GET /me/cloudPCs
GET /me/cloudPCs/{cloudPCId}/retrieveCloudPcLaunchDetail
GET /users/{userId}/cloudPCs/{id}/retrieveCloudPcLaunchDetail
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /deviceManagement/monitoring/alertRecords
GET /deviceManagement/monitoring/alertRecords/{alertRecordId}
GET /deviceManagement/monitoring/alertRecords/getPortalNotifications
GET /deviceManagement/monitoring/alertRules
GET /deviceManagement/monitoring/alertRules/{alertRuleId}
GET /deviceManagement/virtualEndpoint/auditEvents
GET /deviceManagement/virtualEndpoint/auditEvents/{id}
GET /deviceManagement/virtualEndpoint/auditEvents/getAuditActivityTypes
GET /deviceManagement/virtualEndpoint/bulkActions
GET /deviceManagement/virtualEndpoint/bulkActions/{cloudPcBulkActionId}
GET /deviceManagement/virtualEndpoint/cloudApps
GET /deviceManagement/virtualEndpoint/cloudApps/{id}
GET /deviceManagement/virtualEndpoint/cloudPCs
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/retrieveFrontlineCloudPcDetail
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/retrieveReviewStatus
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/getCloudPcConnectivityHistory
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/getSupportedCloudPcRemoteActions
GET /deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='{groupId}',servicePlanId='{servicePlanId}')
GET /deviceManagement/virtualEndpoint/cloudPCs/retrieveCloudPcCountByStatus?customFilter={customFilter}
GET /deviceManagement/virtualEndpoint/crossCloudGovernmentOrganizationMapping
GET /deviceManagement/virtualEndpoint/deviceImages
GET /deviceManagement/virtualEndpoint/deviceImages/{id}
GET /deviceManagement/virtualEndpoint/deviceImages/getSourceImages
GET /deviceManagement/virtualEndpoint/externalPartners
GET /deviceManagement/virtualEndpoint/externalPartners/{cloudPcExternalPartnerId}
GET /deviceManagement/virtualEndpoint/externalPartners/{cloudPcExternalPartnerId}/retrieveActionReports
GET /deviceManagement/virtualEndpoint/externalPartners/{cloudPcExternalPartnerId}/retrieveDeployAgentActionResults(activityId='{activitId}',cloudPcId='{cloudPcId}')
GET /deviceManagement/virtualEndpoint/externalPartnerSettings
GET /deviceManagement/virtualEndpoint/externalPartnerSettings/{cloudPcExternalPartnerSettingId}
GET /deviceManagement/virtualEndpoint/frontLineServicePlans
GET /deviceManagement/virtualEndpoint/frontLineServicePlans/{cloudPcFrontLineServicePlanId}
GET /deviceManagement/virtualEndpoint/galleryImages
GET /deviceManagement/virtualEndpoint/galleryImages/{id}
GET /deviceManagement/virtualEndpoint/getEffectivePermissions
GET /deviceManagement/virtualEndpoint/managedLicenses
GET /deviceManagement/virtualEndpoint/onPremisesConnections
GET /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
GET /deviceManagement/virtualEndpoint/organizationSettings
GET /deviceManagement/virtualEndpoint/provisioningPolicies
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assignments/{assignmentid}/cloudPCUserSettingsPersistence/retrieveUserSettingsPersistenceProfiles(configurationId='{value}')
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assignments/{assignmentid}/cloudPCUserSettingsPersistence/retrieveUserSettingsPersistenceProfileUsage(configurationId='{value}')
GET /deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionLatency(cloudPcId='id')
GET /deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionStatus(cloudPcId='id')
GET /deviceManagement/virtualEndpoint/retrieveScopedPermissions
GET /deviceManagement/virtualEndpoint/retrieveTenantEncryptionSetting
GET /deviceManagement/virtualEndpoint/servicePlans
GET /deviceManagement/virtualEndpoint/snapshots/getStorageAccounts(subscriptionId='{subscriptionId}')
GET /deviceManagement/virtualEndpoint/snapshots/getSubscriptions
GET /deviceManagement/virtualEndpoint/snapshots/retrieveSnapshotImportResult(snapshotId='{snapshotId}')
GET /deviceManagement/virtualEndpoint/supportedRegions
GET /deviceManagement/virtualEndpoint/userSettings
GET /deviceManagement/virtualEndpoint/userSettings/{id}
GET /me/cloudPCs
GET /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
GET /me/cloudPCs/{cloudPCId}/retrieveCloudPcLaunchDetail
GET /me/cloudPCs/{id}
GET /roleManagement/cloudPc/roleAssignments
GET /roleManagement/cloudPC/roleAssignments/{id}
GET /roleManagement/cloudPC/roleDefinitions
GET /roleManagement/cloudPC/roleDefinitions/{id}
GET /roleManagement/defender/roleAssignments
GET /roleManagement/defender/roleDefinitions
GET /roleManagement/defender/roleDefinitions/{id}
GET /roleManagement/deviceManagement/roleAssignments
GET /roleManagement/deviceManagement/roleAssignments/{id}
GET /roleManagement/deviceManagement/roleDefinitions
GET /roleManagement/deviceManagement/roleDefinitions/{id}
GET /roleManagement/directory/roleDefinitions
GET /roleManagement/directory/roleDefinitions/{id}
GET /roleManagement/entitlementManagement/roleDefinitions
GET /roleManagement/entitlementManagement/roleDefinitions/{id}
GET /roleManagement/exchange/roleDefinitions
GET /roleManagement/exchange/roleDefinitions/{id}
GET /tenantRelationships/managedTenants/cloudPcConnections
GET /tenantRelationships/managedTenants/cloudPcConnections/{cloudPcConnectionId}
GET /tenantRelationships/managedTenants/cloudPcDevices
GET /tenantRelationships/managedTenants/cloudPcDevices/{cloudPcDeviceId}
GET /tenantRelationships/managedTenants/cloudPcsOverview
GET /tenantRelationships/managedTenants/cloudPcsOverview/{cloudPcOverviewId}
GET /users/{userId}/cloudPCs/{id}
GET /users/{userId}/cloudPCs/{id}/getCloudPcLaunchInfo
GET /users/{userId}/cloudPCs/{id}/retrieveCloudPcLaunchDetail
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/setReviewStatus
POST /deviceManagement/virtualEndpoint/reports/getActionStatusReports
POST /deviceManagement/virtualEndpoint/reports/getCloudPCPerformanceReport
POST /deviceManagement/virtualEndpoint/reports/getCloudPcRecommendationReports
POST /deviceManagement/virtualEndpoint/reports/getConnectionQualityReports
POST /deviceManagement/virtualEndpoint/reports/getDailyAggregatedRemoteConnectionReports
POST /deviceManagement/virtualEndpoint/reports/getFrontlineReport
POST /deviceManagement/virtualEndpoint/reports/getInaccessibleCloudPcReports
POST /deviceManagement/virtualEndpoint/reports/getRawRemoteConnectionReports
POST /deviceManagement/virtualEndpoint/reports/getRemoteConnectionHistoricalReports
POST /deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport
POST /deviceManagement/virtualEndpoint/reports/getTotalAggregatedRemoteConnectionReports
POST /deviceManagement/virtualEndpoint/reports/retrieveBulkActionStatusReport
POST /deviceManagement/virtualEndpoint/reports/retrieveCloudPcTenantMetricsReport
POST /deviceManagement/virtualEndpoint/reports/retrieveCrossRegionDisasterRecoveryReport
POST /deviceManagement/virtualEndpoint/snapshots/importSnapshot
POST /deviceManagement/virtualEndpoint/snapshots/purgeImportedSnapshot
PATCH /deviceManagement/virtualEndpoint/organizationSettings
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgDeviceManagementVirtualEndpointAuditEvent /deviceManagement/virtualEndpoint/auditEvents
List auditEvents
Get-MgDeviceManagementVirtualEndpointAuditEvent /deviceManagement/virtualEndpoint/auditEvents/{id}
Get cloudPcAuditEvent
Get-MgDeviceManagementVirtualEndpointAuditEventAuditActivityType /deviceManagement/virtualEndpoint/auditEvents/getAuditActivityTypes
cloudPcAuditEvent: getAuditActivityTypes
Get-MgDeviceManagementVirtualEndpointCloudPc /deviceManagement/virtualEndpoint/cloudPCs
List cloudPCs
Get-MgDeviceManagementVirtualEndpointCloudPc /deviceManagement/virtualEndpoint/cloudPCs/{id}
Get cloudPC
Get-MgDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages
List deviceImages
Get-MgDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages/{id}
Get cloudPcDeviceImage
Get-MgDeviceManagementVirtualEndpointDeviceImageSourceImage /deviceManagement/virtualEndpoint/deviceImages/getSourceImages
cloudPcDeviceImage: getSourceImages
Get-MgDeviceManagementVirtualEndpointGalleryImage /deviceManagement/virtualEndpoint/galleryImages
List galleryImages
Get-MgDeviceManagementVirtualEndpointGalleryImage /deviceManagement/virtualEndpoint/galleryImages/{id}
Get cloudPcGalleryImage
Get-MgDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections
List onPremisesConnections
Get-MgDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Get cloudPcOnPremisesConnection
Get-MgDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies
List provisioningPolicies
Get-MgDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
Get cloudPcProvisioningPolicy
Get-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings
List userSettings
Get-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Get cloudPcUserSetting
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaDeviceManagementMonitoringAlertRecord /deviceManagement/monitoring/alertRecords
List alertRecords
Get-MgBetaDeviceManagementMonitoringAlertRecord /deviceManagement/monitoring/alertRecords/{alertRecordId}
Get alertRecord
Get-MgBetaDeviceManagementMonitoringAlertRecordPortalNotification /deviceManagement/monitoring/alertRecords/getPortalNotifications
alertRecord: getPortalNotifications
Get-MgBetaDeviceManagementMonitoringAlertRule /deviceManagement/monitoring/alertRules
List alertRules
Get-MgBetaDeviceManagementMonitoringAlertRule /deviceManagement/monitoring/alertRules/{alertRuleId}
Get alertRule
Get-MgBetaDeviceManagementVirtualEndpointAuditEvent /deviceManagement/virtualEndpoint/auditEvents
List auditEvents
Get-MgBetaDeviceManagementVirtualEndpointAuditEvent /deviceManagement/virtualEndpoint/auditEvents/{id}
Get cloudPcAuditEvent
Get-MgBetaDeviceManagementVirtualEndpointBulkAction /deviceManagement/virtualEndpoint/bulkActions
List bulkActions
Get-MgBetaDeviceManagementVirtualEndpointBulkAction /deviceManagement/virtualEndpoint/bulkActions/{cloudPcBulkActionId}
Get cloudPcBulkAction
Get-MgBetaDeviceManagementVirtualEndpointCloudPc /deviceManagement/virtualEndpoint/cloudPCs
List cloudPCs
Get-MgBetaDeviceManagementVirtualEndpointCloudPc /me/cloudPCs/{id}
Get cloudPC
Get-MgBetaDeviceManagementVirtualEndpointCrossCloudGovernmentOrganizationMapping /deviceManagement/virtualEndpoint/crossCloudGovernmentOrganizationMapping
Get cloudPcCrossCloudGovernmentOrganizationMapping
Get-MgBetaDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages
List deviceImages
Get-MgBetaDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages/{id}
Get cloudPcDeviceImage
Get-MgBetaDeviceManagementVirtualEndpointExternalPartnerSetting /deviceManagement/virtualEndpoint/externalPartnerSettings
List cloudPcExternalPartnerSettings
Get-MgBetaDeviceManagementVirtualEndpointExternalPartnerSetting /deviceManagement/virtualEndpoint/externalPartnerSettings/{cloudPcExternalPartnerSettingId}
Get cloudPcExternalPartnerSetting
Get-MgBetaDeviceManagementVirtualEndpointFrontLineServicePlan /deviceManagement/virtualEndpoint/frontLineServicePlans
List cloudPcFrontLineServicePlans
Get-MgBetaDeviceManagementVirtualEndpointFrontLineServicePlan /deviceManagement/virtualEndpoint/frontLineServicePlans/{cloudPcFrontLineServicePlanId}
Get cloudPcFrontLineServicePlan
Get-MgBetaDeviceManagementVirtualEndpointGalleryImage /deviceManagement/virtualEndpoint/galleryImages
List galleryImages
Get-MgBetaDeviceManagementVirtualEndpointGalleryImage /deviceManagement/virtualEndpoint/galleryImages/{id}
Get cloudPcGalleryImage
Get-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections
List onPremisesConnections
Get-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Get cloudPcOnPremisesConnection
Get-MgBetaDeviceManagementVirtualEndpointOrganizationSetting /deviceManagement/virtualEndpoint/organizationSettings
Get cloudPcOrganizationSettings
Get-MgBetaDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies
List provisioningPolicies
Get-MgBetaDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
Get cloudPcProvisioningPolicy
Get-MgBetaDeviceManagementVirtualEndpointServicePlan /deviceManagement/virtualEndpoint/servicePlans
List servicePlans
Get-MgBetaDeviceManagementVirtualEndpointSnapshot /deviceManagement/virtualEndpoint/snapshots/retrieveSnapshotImportResult(snapshotId='{snapshotId}')
cloudPCSnapshot: retrieveSnapshotImportResult
Get-MgBetaDeviceManagementVirtualEndpointSupportedRegion /deviceManagement/virtualEndpoint/supportedRegions
List supportedRegions
Get-MgBetaDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings
List userSettings
Get-MgBetaDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Get cloudPcUserSetting
Get-MgBetaRoleManagementCloudPcRoleAssignment /roleManagement/cloudPc/roleAssignments
List unifiedRoleAssignmentMultiple
Get-MgBetaRoleManagementCloudPcRoleAssignment /roleManagement/cloudPC/roleAssignments/{id}
Get unifiedRoleAssignmentMultiple
Get-MgBetaRoleManagementCloudPcRoleDefinition /roleManagement/cloudPC/roleDefinitions
List roleDefinitions
Get-MgBetaRoleManagementCloudPcRoleDefinition /roleManagement/cloudPC/roleDefinitions/{id}
Get unifiedRoleDefinition
Get-MgBetaRoleManagementDeviceManagementRoleAssignment /roleManagement/cloudPc/roleAssignments
List unifiedRoleAssignmentMultiple
Get-MgBetaRoleManagementDeviceManagementRoleAssignment /roleManagement/cloudPC/roleAssignments/{id}
Get unifiedRoleAssignmentMultiple
Get-MgBetaRoleManagementDirectoryRoleDefinition /roleManagement/cloudPC/roleDefinitions
List roleDefinitions
Get-MgBetaRoleManagementDirectoryRoleDefinition /roleManagement/cloudPC/roleDefinitions/{id}
Get unifiedRoleDefinition
Get-MgBetaRoleManagementEntitlementManagementRoleDefinition /roleManagement/cloudPC/roleDefinitions
List roleDefinitions
Get-MgBetaRoleManagementEntitlementManagementRoleDefinition /roleManagement/cloudPC/roleDefinitions/{id}
Get unifiedRoleDefinition
Get-MgBetaRoleManagementExchangeRoleDefinition /roleManagement/cloudPC/roleDefinitions
List roleDefinitions
Get-MgBetaRoleManagementExchangeRoleDefinition /roleManagement/cloudPC/roleDefinitions/{id}
Get unifiedRoleDefinition
Get-MgBetaTenantRelationshipManagedTenantCloudPcConnection /tenantRelationships/managedTenants/cloudPcConnections
List cloudPcConnections
Get-MgBetaTenantRelationshipManagedTenantCloudPcConnection /tenantRelationships/managedTenants/cloudPcConnections/{cloudPcConnectionId}
Get cloudPcConnection
Get-MgBetaTenantRelationshipManagedTenantCloudPcDevice /tenantRelationships/managedTenants/cloudPcDevices
List cloudPcDevices
Get-MgBetaTenantRelationshipManagedTenantCloudPcDevice /tenantRelationships/managedTenants/cloudPcDevices/{cloudPcDeviceId}
Get cloudPcDevice
Get-MgBetaTenantRelationshipManagedTenantCloudPcOverview /tenantRelationships/managedTenants/cloudPcsOverview
List cloudPcOverviews
Get-MgBetaTenantRelationshipManagedTenantCloudPcOverview /tenantRelationships/managedTenants/cloudPcsOverview/{cloudPcOverviewId}
Get cloudPcOverview
Update-MgBetaDeviceManagementVirtualEndpointOrganizationSetting /deviceManagement/virtualEndpoint/organizationSettings
Update cloudPcOrganizationSettings

Code Examples

C# / .NET SDK
cloudPC: retrieveCloudPcLaunchDetail
View official example on Microsoft Learn
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.CloudPCs["{cloudPC-id}"].RetrieveCloudPcLaunchDetail.GetAsync();
JavaScript
cloudPC: retrieveCloudPcLaunchDetail
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

let cloudPcLaunchDetail = await client.api('/me/cloudPCs/a20d556d-85f7-88cc-bb9c-08d9902bb7bb/retrieveCloudPcLaunchDetail')
	.get();
PowerShell
cloudPcAuditEvent: getAuditActivityTypes
View official example on Microsoft Learn
Import-Module Microsoft.Graph.DeviceManagement.Administration

Get-MgDeviceManagementVirtualEndpointAuditEventAuditActivityType
Python
cloudPC: retrieveCloudPcLaunchDetail
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.me.cloud_p_cs.by_cloud_p_c_id('cloudPC-id').retrieve_cloud_pc_launch_detail.get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for CloudPC.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.