Public/Get-AzureAdDirectLicenseAssignments.ps1

<#PSScriptInfo

.VERSION 2.0.6

.GUID f05dd4da-b51c-41e0-9bc2-92888c536c8e

.AUTHOR Nicola Suter

.COMPANYNAME Tectic

.COPYRIGHT Copyright (c) Tectic 2026

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES


.PRIVATEDATA


#>

<#

.DESCRIPTION
Script to cleanup direct Azure AD license assignments. This script will only remove a direct assignment if there is an associated group assignment. Before running the script make sure that you have the MSOnline PowerShell module installed. Connect to MSOnline with: Connect-MsolService

.PARAMETER WhatIf
Predict changes
.PARAMETER SaveReport
Whether to save the report to the script location.
.LINK
https://github.com/nicolonsky/Techblog/tree/master/CleanupAzureADLicensing
.LINK
https://learn.microsoft.com/en-us/azure/active-directory/enterprise-users/licensing-groups-migrate-users
#>


[CmdletBinding(SupportsShouldProcess)]
param(
  $Users = (Get-MsolUser -All -ErrorAction Stop),
  $Skus = ("ATP_ENTERPRISE", "ATP_ENTERPRISE", "ENTERPRISEPACK")
)

Requires -Module MSOnline

$Results = @()

$Users | ForEach-Object {
  Write-Verbose "Processing $($_.UserPrincipalName)"
  $count++ ; Progress -Index $count -Total $Users.count -Activity "Processing all licenses." -Name $_.UserPrincipalName
  $User = $_
  $_.Licenses | ForEach-Object {
    <#
      the "GroupsAssigningLicense" array contains objectId's of groups which inherit licenses
      if the array contains an entry with the users own objectId the license was assigned directly to the user
      if the array contains no entries and the user has a license assigned he also got a direct license assignment
      #>

    $_.AccountSkuId -match '\:(.*)' | Out-Null ; $Sku = $Matches[1]
    if ($_.GroupsAssigningLicense -contains $User.ObjectId -and $Sku -in $Skus) {
      Write-Verbose "$($User.UserPrincipalName) ($($User.ObjectId)) has direct license assignment for '$($_.AccountSkuId)'"
      $_.GroupsAssigningLicense.Remove($User.ObjectId) | Out-Null

      $Result = [PSCustomObject]@{
        UserPrincipalName      = $user.UserPrincipalName
        ObjectId               = $user.ObjectId
        GroupsAssigningLicense = $_.GroupsAssigningLicense
        AccountSkuId           = $_.AccountSkuId
      }
      $Results += $Result
      return $Result
    }
  }

}

if ($Results) { Write-Warning "Found $($Results.Count) direct assigned license(s)." }
else { Write-Output "No direct license assignments found" }