This cmdlet is available only in the cloud-based service.

This cmdlet was deprecated in January, 2018. For information about the available replacement Microsoft Graph reports in Microsoft 365, see the subtopics of Working with Microsoft 365 usage reports in Microsoft Graph.

Use the Get-LicenseVsUsageSummaryReport cmdlet to retrieve a report that identifies the number of active users for installed software licenses (workloads).

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.


Get-LicenseVsUsageSummaryReport []


This cmdlet produces a report that is intended to enable clients to track and manage the use of contracted software licenses. The output contains the following properties.

  • Date: The period being measured.
  • TenantGuid: The unique identifier for the Exchange Online tenant.
  • Workload: The workload whose users are being counted. The current workloads include: Exchange Online, SharePoint Online, Skype for Business Online, and Microsoft Viva Engage.
  • NonTrialEntitlements: The number of entitled users for the workload.
  • TrialEntitlements: The number of provisionally entitled (trial) users for the workload.
  • ActiveUsers: The count of active users for the workload.

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.


Example 1


This example gets a report of the active workload users.