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

CloudPC.ReadWrite.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read/Write All Resources

Allows the app to read and write 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 and write Cloud PCs

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

Permission ID: 3b4349e1-8cf5-45a3-95b7-69d1751d3e6a
Delegated Permission Admin consent required

Read and write Cloud PCs

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

User sees: Allows the app to read and write the properties of Cloud PCs, on your behalf.
Permission ID: 9d77138f-f0e2-47ba-ab33-cd246c8b79d1

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
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/endGracePeriod
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/reboot
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/troubleshoot
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/resize
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/restore
POST /deviceManagement/virtualEndpoint/deviceImages
POST /deviceManagement/virtualEndpoint/onPremisesConnections
POST /deviceManagement/virtualEndpoint/onPremisesConnections/{id}/runHealthChecks
POST /deviceManagement/virtualEndpoint/provisioningPolicies
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assign
POST /deviceManagement/virtualEndpoint/report/retrieveCloudPcRecommendationReports
POST /deviceManagement/virtualEndpoint/userSettings
POST /deviceManagement/virtualEndpoint/userSettings/{id}/assign
POST /me/cloudPCs/{id}/reprovision
POST /users/{userId}/cloudPCs/{id}/reprovision
PATCH /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
PATCH /deviceManagement/virtualEndpoint/userSettings/{id}
DELETE /deviceManagement/virtualEndpoint/deviceImages/{id}
DELETE /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
DELETE /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
DELETE /deviceManagement/virtualEndpoint/userSettings/{id}
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/{id}
GET /deviceManagement/virtualEndpoint/cloudPCs
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getFrontlineCloudPcAccessState
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/retrieveFrontlineCloudPcDetail
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/retrieveReviewStatus
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/retrieveSnapshots
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/getCloudPcConnectivityHistory
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/getSupportedCloudPcRemoteActions
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/retrieveCloudPcRemoteActionResults
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}/retrievePolicyApplyActionResult
GET /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/retrievePolicyApplySchedule
GET /deviceManagement/virtualEndpoint/reports/exportJobs/{cloudPcExportJobId}
GET /deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionLatency(cloudPcId='id')
GET /deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionStatus(cloudPcId='id')
GET /deviceManagement/virtualEndpoint/retrieveScopedPermissions
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}/getFrontlineCloudPcAccessState
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/monitoring/alertRecords/{alertRecordId}/setPortalNotificationAsSent
POST /deviceManagement/monitoring/alertRecords/changeAlertRecordsPortalNotificationAsSent
POST /deviceManagement/monitoring/alertRules
POST /deviceManagement/virtualEndpoint/bulkAction/{id}/retry
POST /deviceManagement/virtualEndpoint/bulkActions
POST /deviceManagement/virtualEndpoint/cloudApps/publish
POST /deviceManagement/virtualEndpoint/cloudApps/reset
POST /deviceManagement/virtualEndpoint/cloudApps/retrieveDiscoveredApps(sourceId={value},provisioningPolicyId={value})
POST /deviceManagement/virtualEndpoint/cloudApps/unpublish
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/changeUserAccountType
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/poweroff
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/poweron
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/reboot
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/setReviewStatus
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/start
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/stop
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/troubleshoot
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/createSnapshot
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/resize
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/restore
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/retryPartnerAgentInstallation
POST /deviceManagement/virtualEndpoint/cloudPCs/4b18de4b-ab05-4059-8c61-0323a7df4ced/endGracePeriod
POST /deviceManagement/virtualEndpoint/cloudPCs/validateBulkResize
POST /deviceManagement/virtualEndpoint/crossCloudGovernmentOrganizationMapping
POST /deviceManagement/virtualEndpoint/deviceImages
POST /deviceManagement/virtualEndpoint/deviceImages/{cloudPcDeviceImageId}/retryUpload
POST /deviceManagement/virtualEndpoint/deviceImages/{cloudPcDeviceImageId}/reupload
POST /deviceManagement/virtualEndpoint/externalPartners
POST /deviceManagement/virtualEndpoint/externalPartnerSettings
POST /deviceManagement/virtualEndpoint/onPremisesConnections
POST /deviceManagement/virtualEndpoint/onPremisesConnections/{id}/runHealthChecks
POST /deviceManagement/virtualEndpoint/onPremisesConnections/{Id}/UpdateAdDomainPassword
POST /deviceManagement/virtualEndpoint/provisioningPolicies
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/apply
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assign
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assignments/{assignmentid}/cloudPCUserSettingsPersistence/batchCleanupUserSettingsPersistenceProfile
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/schedulePolicyApplyTask
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{provisioningPolicyId}/retry
POST /deviceManagement/virtualEndpoint/provisioningPolicies/applyConfig
POST /deviceManagement/virtualEndpoint/report/retrieveCloudPcClientAppUsageReport
POST /deviceManagement/virtualEndpoint/report/retrieveCloudPcRecommendationReports
POST /deviceManagement/virtualEndpoint/reports/exportJobs
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/retrieveCloudPcRecommendationReports
POST /deviceManagement/virtualEndpoint/reports/retrieveCloudPcTenantMetricsReport
POST /deviceManagement/virtualEndpoint/reports/retrieveCloudPcTroubleshootReports
POST /deviceManagement/virtualEndpoint/reports/retrieveCrossRegionDisasterRecoveryReport
POST /deviceManagement/virtualEndpoint/snapshots/importSnapshot
POST /deviceManagement/virtualEndpoint/snapshots/purgeImportedSnapshot
POST /deviceManagement/virtualEndpoint/userSettings
POST /deviceManagement/virtualEndpoint/userSettings/{id}/assign
POST /me/cloudPCs/{cloudPCId}/reboot
POST /me/cloudPCs/{cloudPCId}/rename
POST /me/cloudPCs/{cloudPCId}/start
POST /me/cloudPCs/{cloudPCId}/stop
POST /me/cloudPCs/{cloudPCId}/troubleshoot
POST /me/cloudPCs/{id}/reprovision
POST /roleManagement/cloudPC/roleAssignments
POST /roleManagement/cloudPc/roleDefinitions
POST /roleManagement/defender/roleAssignments
POST /roleManagement/defender/roleDefinitions
POST /roleManagement/deviceManagement/roleAssignments
POST /roleManagement/deviceManagement/roleDefinitions
POST /roleManagement/directory/roleDefinitions
POST /users/{userId}/cloudPCs/{cloudPCId}/reboot
POST /users/{userId}/cloudPCs/{cloudPCId}/rename
POST /users/{userId}/cloudPCs/{cloudPCId}/troubleshoot
POST /users/{userId}/cloudPCs/{id}/reprovision
POST /users/{userId}/cloudPCs/{id}/start
POST /users/{userId}/cloudPCs/{id}/stop
PATCH /deviceManagement/monitoring/alertRules/{alertRuleId}
PATCH /deviceManagement/virtualEndpoint/cloudApps/{id}
PATCH /deviceManagement/virtualEndpoint/externalPartners/{cloudPcExternalPartnerId}
PATCH /deviceManagement/virtualEndpoint/externalPartnerSettings/{cloudPcExternalPartnerSettingId}
PATCH /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
PATCH /deviceManagement/virtualEndpoint/organizationSettings
PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
PATCH /deviceManagement/virtualEndpoint/userSettings/{id}
PATCH /roleManagement/cloudPC/roleAssignments/{id}
PATCH /roleManagement/cloudPc/roleDefinitions/{id}
PATCH /roleManagement/deviceManagement/roleAssignments/{id}
PATCH /roleManagement/deviceManagement/roleDefinitions/{id}
PATCH /roleManagement/directory/roleDefinitions/{id}
DELETE /deviceManagement/virtualEndpoint/deviceImages/{id}
DELETE /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
DELETE /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
DELETE /deviceManagement/virtualEndpoint/userSettings/{id}
DELETE /roleManagement/cloudPC/roleAssignments/{id}
DELETE /roleManagement/cloudPc/roleDefinitions/{id}
DELETE /roleManagement/defender/roleAssignments/{id}
DELETE /roleManagement/defender/roleDefinitions/{id}
DELETE /roleManagement/deviceManagement/roleAssignments/{id}
DELETE /roleManagement/deviceManagement/roleDefinitions/{id}
DELETE /roleManagement/directory/roleDefinitions/{id}
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-MgDeviceManagementVirtualEndpointReportCloudPcRecommendationReport /deviceManagement/virtualEndpoint/report/retrieveCloudPcRecommendationReports
cloudPcReport: retrieveCloudPcRecommendationReports
Get-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings
List userSettings
Get-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Get cloudPcUserSetting
Invoke-MgReprovisionDeviceManagementVirtualEndpointCloudPc /me/cloudPCs/{id}/reprovision
cloudPC: reprovision
Invoke-MgTroubleshootDeviceManagementVirtualEndpointCloudPc /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/troubleshoot
cloudPC: troubleshoot
New-MgDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages
Create cloudPcDeviceImage
New-MgDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections
Create cloudPcOnPremisesConnection
New-MgDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies
Create cloudPcProvisioningPolicy
New-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings
Create cloudPcUserSetting
Remove-MgDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages/{id}
Delete cloudPcDeviceImage
Remove-MgDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Delete cloudPcOnPremisesConnection
Remove-MgDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
Delete cloudPcProvisioningPolicy
Remove-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Delete cloudPcUserSetting
Set-MgDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assign
cloudPcProvisioningPolicy: assign
Set-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}/assign
cloudPcUserSetting: assign
Update-MgDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Update cloudPcOnPremisesConnection
Update-MgDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
Update cloudPcProvisioningPolicy
Update-MgDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Update 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-MgBetaDeviceManagementVirtualEndpointReportExportJob /deviceManagement/virtualEndpoint/reports/exportJobs/{cloudPcExportJobId}
Get cloudPcExportJob
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
New-MgBetaDeviceManagementMonitoringAlertRule /deviceManagement/monitoring/alertRules
Create alertRule
New-MgBetaDeviceManagementVirtualEndpointBulkAction /deviceManagement/virtualEndpoint/bulkActions
Create cloudPcBulkAction
New-MgBetaDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages
Create cloudPcDeviceImage
New-MgBetaDeviceManagementVirtualEndpointExternalPartnerSetting /deviceManagement/virtualEndpoint/externalPartnerSettings
Create cloudPcExternalPartnerSetting
New-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections
Create cloudPcOnPremisesConnection
New-MgBetaDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies
Create cloudPcProvisioningPolicy
New-MgBetaDeviceManagementVirtualEndpointReportExportJob /deviceManagement/virtualEndpoint/reports/exportJobs
Create cloudPcExportJob
New-MgBetaDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings
Create cloudPcUserSetting
New-MgBetaRoleManagementCloudPcRoleAssignment /roleManagement/cloudPC/roleAssignments
Create unifiedRoleAssignmentMultiple
New-MgBetaRoleManagementCloudPcRoleDefinition /roleManagement/deviceManagement/roleDefinitions
Create roleDefinitions
New-MgBetaRoleManagementDeviceManagementRoleAssignment /roleManagement/cloudPC/roleAssignments
Create unifiedRoleAssignmentMultiple
New-MgBetaRoleManagementDirectoryRoleDefinition /roleManagement/deviceManagement/roleDefinitions
Create roleDefinitions
Remove-MgBetaDeviceManagementVirtualEndpointDeviceImage /deviceManagement/virtualEndpoint/deviceImages/{id}
Delete cloudPcDeviceImage
Remove-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Delete cloudPcOnPremisesConnection
Remove-MgBetaDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
Delete cloudPcProvisioningPolicy
Remove-MgBetaDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Delete cloudPcUserSetting
Remove-MgBetaRoleManagementCloudPcRoleAssignment /roleManagement/cloudPC/roleAssignments/{id}
Delete unifiedRoleAssignmentMultiple
Remove-MgBetaRoleManagementCloudPcRoleDefinition /roleManagement/deviceManagement/roleDefinitions/{id}
Delete unifiedRoleDefinition
Remove-MgBetaRoleManagementDeviceManagementRoleAssignment /roleManagement/cloudPC/roleAssignments/{id}
Delete unifiedRoleAssignmentMultiple
Remove-MgBetaRoleManagementDirectoryRoleDefinition /roleManagement/deviceManagement/roleDefinitions/{id}
Delete unifiedRoleDefinition
Set-MgBetaDeviceManagementMonitoringAlertRecordPortalNotificationAsSent /deviceManagement/monitoring/alertRecords/{alertRecordId}/setPortalNotificationAsSent
alertRecord: setPortalNotificationAsSent
Update-MgBetaDeviceManagementMonitoringAlertRule /deviceManagement/monitoring/alertRules/{alertRuleId}
Update alertRule
Update-MgBetaDeviceManagementVirtualEndpointExternalPartnerSetting /deviceManagement/virtualEndpoint/externalPartnerSettings/{cloudPcExternalPartnerSettingId}
Update cloudPcExternalPartnerSetting
Update-MgBetaDeviceManagementVirtualEndpointOnPremiseConnection /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Update cloudPcOnPremisesConnection
Update-MgBetaDeviceManagementVirtualEndpointOrganizationSetting /deviceManagement/virtualEndpoint/organizationSettings
Update cloudPcOrganizationSettings
Update-MgBetaDeviceManagementVirtualEndpointProvisioningPolicy /deviceManagement/virtualEndpoint/provisioningPolicies/{id}
Update cloudPcProvisioningPolicy
Update-MgBetaDeviceManagementVirtualEndpointUserSetting /deviceManagement/virtualEndpoint/userSettings/{id}
Update cloudPcUserSetting
Update-MgBetaRoleManagementCloudPcRoleAssignment /roleManagement/cloudPC/roleAssignments/{id}
Update unifiedRoleAssignmentMultiple
Update-MgBetaRoleManagementCloudPcRoleDefinition /roleManagement/deviceManagement/roleDefinitions/{id}
Update unifiedRoleDefinition
Update-MgBetaRoleManagementDeviceManagementRoleAssignment /roleManagement/cloudPC/roleAssignments/{id}
Update unifiedRoleAssignmentMultiple
Update-MgBetaRoleManagementDirectoryRoleDefinition /roleManagement/deviceManagement/roleDefinitions/{id}
Update unifiedRoleDefinition

Code Examples

C# / .NET SDK
cloudPC: endGracePeriod
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
await graphClient.DeviceManagement.VirtualEndpoint.CloudPCs["{cloudPC-id}"].EndGracePeriod.PostAsync();
JavaScript
cloudPC: endGracePeriod
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/deviceManagement/virtualEndpoint/cloudPCs/4b18de4b-ab05-4059-8c61-0323a7df4ced/endGracePeriod')
	.post();
PowerShell
cloudPC: endGracePeriod
View official example on Microsoft Learn
Import-Module Microsoft.Graph.DeviceManagement.Administration

Stop-MgDeviceManagementVirtualEndpointCloudPcGracePeriod -CloudPCId $cloudPCId
Python
cloudPC: endGracePeriod
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

await graph_client.device_management.virtual_endpoint.cloud_p_cs.by_cloud_p_c_id('cloudPC-id').end_grace_period.post()

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.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent.