Get-CloudPCLicensingAllotment
Returns Microsoft Graph cloud licensing allotments.
Description
Calls the Microsoft Graph beta /admin/cloudLicensing/allotments endpoint and returns normalized WindowsCloudPC.LicensingAllotment objects.
By default, the cmdlet lists every allotment. Pass -Id to retrieve a single allotment. Optional OData query parameters can be used to shape the Graph response for testing the beta endpoint.
Syntax
Get-CloudPCLicensingAllotment [[-Id] <string>] [-Select <string[]>] [-Expand <string>] [-Filter <string>] [-Top <int>] [-Apply <string>] [<CommonParameters>]
Parameters
| Name | Type | Required | Aliases | Description |
|---|---|---|---|---|
Apply | String | No | Optional OData $apply expression for list queries. | |
Expand | String | No | Optional OData $expand expression. | |
Filter | String | No | Optional OData $filter expression. | |
Id | String | No | AllotmentId | Optional allotment ID. When provided, the cmdlet retrieves only that allotment. |
Select | String[] | No | Property | Optional OData $select fields. |
Top | Int32 | No | Optional OData $top value for list queries. |
Output
Id : rj67nvi64ofj4cywlkxpja6tbywpqkifkhed7fi2f5cwbej5le74
SkuId : 00000000-0000-0000-0000-000000000000
SkuPartNumber : Microsoft_365_E5_(no_Teams)
AllottedUnits : 25
ConsumedUnits : 25
AvailableUnits : 0
AssignableTo : user,group
ServiceCount : 96
ServicePlanNames : {REMOTE_HELP, Intune-MAMTunnel, Intune-EPM, Intune_ServiceNow…}
Services : {REMOTE_HELP, Intune-MAMTunnel, Intune-EPM, Intune_ServiceNow…}
SubscriptionCount : 0
SubscriptionIds : {}
Subscriptions : {}
WaitingMemberCount : 1
WaitingMembers : {$null}
Raw : {[skuId, 00000000-0000-0000-0000-000000000000], [allottedUnits, 25], [consumedUnits, 25], [services, System.Object[]]…
Graph endpoints
/beta/admin/cloudLicensing/allotments/
/beta/admin/cloudLicensing/allotments
Example 1
Get-CloudPCLicensingAllotment | Format-Table SkuPartNumber,AllottedUnits,ConsumedUnits,AvailableUnits
Lists licensing allotments with capacity and consumption.
Example 2
Get-CloudPCLicensingAllotment -Id 'fde42873-30b6-436b-b361-21af5a6b84ae'
Gets one licensing allotment by ID.
Example 3
Get-CloudPCLicensingAllotment -Select id,skuPartNumber,allottedUnits,consumedUnits -Expand 'waitingMembers($select=id,waitingSinceDateTime)'
Lists licensing allotments with selected fields and expanded waiting members.