License reports
Backed by Microsoft Graph with a cached SKU catalog. For full details and examples, run Get-Help <FunctionName> -Detailed.
Add-UserMsolAccountSku
Assign licenses by friendly name (resolved via catalog), SKU part number, or SKU ID to a user.
Syntax
Add-UserMsolAccountSku -UserPrincipalName <String> -License <String[]> [-ForceLicenseCatalogRefresh]
| Parameter | Description | Required |
|---|---|---|
UserPrincipalName | Target user UPN or object ID. | Yes |
License | Friendly name, SKU part number, or SKU ID. Accepts multiple values. | Yes |
ForceLicenseCatalogRefresh | Redownload license catalog cache. | No |
Examples
Add-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -License 'Microsoft 365 E3'
Add-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -License 'ENTERPRISEPACK','VISIOCLIENT'
Add-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -License '18181a46-0d4e-45cd-891e-60aabd171b4e'
If the target user has no UsageLocation, Nebula.Core sets it automatically using the UsageLocation key from your configuration (default US, override via %USERPROFILE%\.NebulaCore\settings.psd1). If updating the usage location fails, license assignment stops.
If the tenant does not have units available for the requested license, the assignment is avoided and a warning message is displayed.
Copy-UserMsolAccountSku
Copy all licenses (with disabled plans preserved) from one user to another without removing them from the source.
Syntax
Copy-UserMsolAccountSku -SourceUserPrincipalName <String> -DestinationUserPrincipalName <String>
| Parameter | Description | Required |
|---|---|---|
SourceUserPrincipalName | Source user UPN or object ID. | Yes |
DestinationUserPrincipalName | Destination user UPN or object ID. | Yes |
Example
Copy-UserMsolAccountSku -SourceUserPrincipalName 'user1@contoso.com' -DestinationUserPrincipalName 'user2@contoso.com'
Export-MsolAccountSku
Export all users with assigned licenses to CSV, mapping SKU part numbers to friendly names.
Syntax
Export-MsolAccountSku [-CsvFolder <String>] [-ForceLicenseCatalogRefresh]
| Parameter | Description | Required | Default |
|---|---|---|---|
CsvFolder | Output folder. | No | Current directory |
ForceLicenseCatalogRefresh | Redownload the license catalog cache. | No | False |
Example
Export-MsolAccountSku -CsvFolder 'C:\Temp\Reports'
Get-TenantMsolAccountSku
List tenant SKUs with resolved names, totals, consumed, available (net of suspended), and seat states (filter by name or SKU part number).
Syntax
Get-TenantMsolAccountSku [-ForceLicenseCatalogRefresh] [-Filter <String>] [-SampleUsers <Int32>] [-AsTable] [-GridView]
| Parameter | Description | Required | Default |
|---|---|---|---|
ForceLicenseCatalogRefresh | Redownload license catalog cache. | No | False |
Filter | Show only licenses whose name or SkuPartNumber contains the provided text. | No | |
SampleUsers | Return up to N sample users per license (requires -Filter). Defaults to 5 when specified. | No | 5 |
AsTable | Format output as a table. | No | False |
GridView | Show output in a GridView window. | No | False |
Example
Get-TenantMsolAccountSku -AsTable
Get-TenantMsolAccountSku -Filter "E3" -AsTable
Get-TenantMsolAccountSku -Filter "E3" -SampleUsers
Available is calculated net of suspended seats: (TotalCount - Suspended) - Consumed. The Total column shows a friendly breakdown (Enabled/Suspended), while TotalCount remains the numeric total for scripting.
Need renewal/expiration or billing profile details? Open the Microsoft 365 Admin Center subscriptions page:
https://admin.cloud.microsoft/?#/subscriptions
Get-UserMsolAccountSku
Show licenses assigned to a single user with friendly names.
Syntax
Get-UserMsolAccountSku -UserPrincipalName <String> [-Clipboard] [-ForceLicenseCatalogRefresh]
| Parameter | Description | Required |
|---|---|---|
UserPrincipalName | Target UPN or object ID. | Yes |
Clipboard | Copy the resolved license names (fallback: SkuPartNumber) to the clipboard as "License1","License2". | No |
ForceLicenseCatalogRefresh | Redownload license catalog cache. | No |
Example
Get-UserMsolAccountSku -UserPrincipalName 'user@contoso.com'
'user1@contoso.com','user2@contoso.com' | Get-UserMsolAccountSku
Get-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -Clipboard
Move-UserMsolAccountSku
Move all licenses (with disabled plans preserved) from one user to another.
Syntax
Move-UserMsolAccountSku -SourceUserPrincipalName <String> -DestinationUserPrincipalName <String>
| Parameter | Description | Required |
|---|---|---|
SourceUserPrincipalName | Source user UPN or object ID. | Yes |
DestinationUserPrincipalName | Destination user UPN or object ID. | Yes |
Example
Move-UserMsolAccountSku -SourceUserPrincipalName 'user1@contoso.com' -DestinationUserPrincipalName 'user2@contoso.com'
Remove-UserMsolAccountSku
Remove licenses from a user by friendly name (resolved via catalog), SKU part number, or SKU ID.
Syntax
Remove-UserMsolAccountSku -UserPrincipalName <String> -License <String[]> [-ForceLicenseCatalogRefresh]
| Parameter | Description | Required |
|---|---|---|
UserPrincipalName | Target user UPN or object ID. | Yes |
License | Friendly name, SKU part number, or SKU ID. Accepts multiple values. | Yes |
ForceLicenseCatalogRefresh | Redownload license catalog cache. | No |
Remove-UserMsolAccountSku -UserPrincipalName <String> -All [-ForceLicenseCatalogRefresh]
| Parameter | Description | Required |
|---|---|---|
UserPrincipalName | Target user UPN or object ID. | Yes |
All | Remove all assigned licenses. | Yes |
ForceLicenseCatalogRefresh | Redownload license catalog cache. | No |
Examples
Remove-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -License 'Microsoft 365 E3'
Remove-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -License 'ENTERPRISEPACK','VISIOCLIENT'
Remove-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -License '18181a46-0d4e-45cd-891e-60aabd171b4e'
Remove-UserMsolAccountSku -UserPrincipalName 'user@contoso.com' -All
Update-LicenseCatalog
Refresh the local license catalog cache (download SKU mappings).
Syntax
Update-LicenseCatalog [-Force]
| Parameter | Description |
|---|---|
Force | Force a refresh even if cache exists. |
Example
Update-LicenseCatalog -Force
Questions and answers
Can I export licenses/mailboxes without Graph?
No. License functions and some statistics require Microsoft Graph for complete data. Ensure Connect-Nebula requested the right scopes.