Get-MgUserLicenseDetail Graph PowerShell Cmdlet

What is Microsoft 365 User License?

Microsoft 365 licenses determine what services and features a user can access within the Microsoft ecosystem. Administrators assign licenses to users based on their roles and requirements. Some licenses provide access to Office apps, while others grant permissions to security and compliance tools. Managing and tracking these licenses is crucial to ensure proper allocation and compliance within an organization.

Why Use Get-MgUserLicenseDetail?

The Get-MgUserLicenseDetail cmdlet in Microsoft Graph PowerShell helps administrators retrieve detailed information about assigned licenses for specific users. This cmdlet is useful for:

• Auditing assigned licenses within the organization
• Ensuring compliance with purchased license quotas
• Tracking license usage trends
• Identifying unlicensed users or those with redundant assignments
• Automating reports for license management

Setting Up Microsoft Graph PowerShell

Before using Get-MgUserLicenseDetail, you must set up the Microsoft Graph PowerShell module.

Install the Module

Run the following command to install the Microsoft Graph module:

Install-Module Microsoft.Graph -Scope CurrentUser

This installs the module for the current user without requiring administrative privileges.

Connect to Microsoft Graph

Authenticate and connect to Microsoft Graph with the necessary permissions:

Connect-MgGraph -Scopes "User.Read.All"

You'll be prompted to sign in using your Microsoft 365 administrator account.

Disconnect After Use

Once you've completed your tasks, always disconnect the session:

Disconnect-MgGraph  

This helps prevent unnecessary active sessions and improves security.

Exploring the Get-MgUserLicenseDetail Cmdlet

The Get-MgUserLicenseDetail cmdlet retrieves license details for a specific user or all users in the organization. This cmdlet is essential for tracking and managing Microsoft 365 licenses efficiently.

Cmdlet Syntax

Get-MgUserLicenseDetail [-UserId <String>] [<CommonParameters>]

• -UserId: Specifies the user by their User Principal Name (UPN) or Object ID.
• If no parameters are provided, the cmdlet returns details for the authenticated user.

Practical Examples of Get-MgUserLicenseDetail

1. Executing Get-MgUserLicenseDetail Without Parameters

You can directly execute Get-MgUserLicenseDetail cmdlet and then pass in the User Id or UPN when prompted by the PowerShell console.

Get-MgUserLicenseDetail

2. Passing UserId or UPN to Get-MgUserLicenseDetail Directly

By Passing UPN

Get-MgUserLicenseDetail -UserId "samadmin@7xh7fj.onmicrosoft.com"

This retrieves the license details of the user identified by their User Principal Name (UPN).

By Passing User ID

Get-MgUserLicenseDetail -UserId "1111-2222-4555-67676"

This retrieves the license details for the user identified by their unique Object ID.

3. Fetching License Details for All Users

To fetch and export license details for all users, use the following script:

$users = Get-MgUser
foreach ($user in $users){
   Get-MgUserLicenseDetail -UserId $user.Id | Export-Csv -Path "WeeklyUserLicenseDetails.csv" -NoTypeInformation -Append
}

This script:

• Retrieves all users in the organization
• Iterates through each user and fetches their license details
• Exports the details to a CSV file for reporting purposes

Best Practices for Get-MgUserLicenseDetail

To optimize the use of Get-MgUserLicenseDetail, follow these best practices:

• Use Filters for Large Organizations: Instead of retrieving all users, filter based on groups or attributes.
• Schedule Automated Reports: Automate license reporting using scheduled PowerShell scripts to monitor usage trends.
• Monitor License Expirations: Regularly audit licenses to prevent service disruptions due to expired licenses.
• Ensure Proper Permissions: Always run the cmdlet with an account that has sufficient permissions.
• Avoid Unnecessary API Calls: Minimize redundant queries to prevent throttling and improve performance.

Conclusion

The Get-MgUserLicenseDetail cmdlet is a powerful tool for Microsoft 365 administrators to monitor and manage user licenses effectively. By leveraging the cmdlet’s capabilities, IT teams can maintain compliance, optimize license assignments, and streamline administrative tasks. Implementing best practices ensures efficient usage while preventing licensing issues within the organization.

Try incorporating Get-MgUserLicenseDetail into your daily PowerShell routines to enhance Microsoft 365 license management!