Skip to main content

Examples

These examples show common workflows. For full syntax and parameters, use the command reference.

Export a Cloud PC inventory​

Get-CloudPC |
    Select-Object Name,Id,ProvisioningStatus,ProvisioningType,AssignedUserUpn,ProvisioningPolicyId |
    Export-Csv .\cloudpc-inventory.csv -NoTypeInformation

Find idle Cloud PCs​

Get-CloudPCUsage |
    Where-Object DaysSinceLastSignIn -ge 14 |
    Sort-Object DaysSinceLastSignIn -Descending |
    Format-Table CloudPcName,AssignedUserUpn,UsageStatus,DaysSinceLastSignIn

Show Cloud PCs by provisioning policy​

Get-CloudPCByProvisioningPolicy |
    Sort-Object DisplayName |
    Format-Table DisplayName,ProvisioningType,CloudPCCount,AssignedGroupCount

Export and copy a provisioning policy​

Export-CloudPCProvisioningPolicy -Id '<policy-id>' -Path .\policy-export.json

New-CloudPCProvisioningPolicy -Path .\policy-export.json `
    -DisplayName 'Copied Policy' `
    -Assign `
    -Force

Delete a copied provisioning policy​

Remove-CloudPCProvisioningPolicy -Id '<policy-id>' -WhatIf
Remove-CloudPCProvisioningPolicy -Id '<policy-id>' -Force -PassThru

Review launch detail for every Cloud PC​

Get-CloudPC |
    Get-CloudPCLaunchDetail |
    Format-Table CloudPcName,UserId,LaunchDetailStatus,Windows365SwitchCompatible,WindowsAppLaunchUri

List restore point snapshots for a user​

Get-CloudPCSnapshot -User 'user@contoso.com' -Verbose |
    Format-Table CloudPcName,Status,SnapshotType,CreatedDateTime

List every Cloud PC and its restore points​

Get-CloudPCSnapshot -All -Verbose |
    Sort-Object CloudPcName,CreatedDateTime -Descending |
    Format-Table CloudPcName,Status,SnapshotType,CreatedDateTime

Create snapshots for a provisioning policy​

New-CloudPCSnapshot -ProvisioningPolicyId '<policy-id>' `
    -ExcludeCloudPC 'CPC-KEEP-01','user4@contoso.com' `
    -Force |
    Format-Table CloudPcName,AssignedUserUpn,Status,Excluded,ErrorMessage

Reprovision a policy except excluded Cloud PCs​

Invoke-CloudPCPolicyReprovision -ProvisioningPolicyId '<policy-id>' `
    -ExcludeCloudPC 'CPC-KEEP-01','CPC-KEEP-02','cpc-id-3' `
    -OsVersion windows11 -UserAccountType standardUser -Force

Review recent remote action results​

Get-CloudPCRemoteActionResult -CloudPC '<cloud-pc-id>' |
    Sort-Object StartDateTime -Descending |
    Format-Table ActionName,ActionState,StartDateTime,LastUpdatedDateTime

List licensing allotments​

Get-CloudPCLicensingAllotment |
    Format-Table SkuPartNumber,AllottedUnits,ConsumedUnits,AvailableUnits

Find low license capacity​

Get-CloudPCLicensingAllotment |
    Where-Object AvailableUnits -lt 10 |
    Sort-Object AvailableUnits |
    Format-Table SkuPartNumber,AllottedUnits,ConsumedUnits,AvailableUnits