Find Teams Rooms devices with unsupported licenses

Resource accounts that only have user licenses or Microsoft Teams Shared Device licenses assigned to them aren't supported for use with Microsoft Teams Rooms devices. Resource accounts used with Teams Rooms devices need to be assigned one of the following licenses:

  • Microsoft Teams Rooms Pro
  • Microsoft Teams Rooms Basic
  • Microsoft Teams Rooms Standard (legacy)
  • Microsoft Teams Rooms Premium (legacy)

Important

Teams Rooms devices logged in with resource accounts that don't have one of the above supported Teams Rooms licenses assigned to them won't be able to sign in after July 1, 2023. To ensure your Teams Rooms devices can continue to sign in after July 1, 2023, use the information in this article to make sure they have a supported Teams Rooms license.

You have a couple of options for checking whether the resource accounts signed into your Teams Rooms devices have a Teams Rooms license. If you only have a couple Teams Rooms devices, use the steps in Check the license of a few Teams Rooms devices. If you have more than a few Teams Rooms devices, use the steps in Check the license of multiple Microsoft Teams Rooms devices.

For information about Teams Rooms licensing, see Microsoft Teams Rooms licenses.

Check the license of a couple Teams Rooms devices

For a small number of devices, you can see what license your devices have by going to Teams devices in the Teams admin center, and then selecting the device category (Teams Rooms on Windows, Teams Rooms on Android, or Surface Hubs) you want to see.

For example, if you select Teams devices > Teams Rooms on Windows, you'll see the following image. The License column shows the Teams Rooms license assigned to each device.

Teams Rooms inventory list with focus on Standard, Pro, and Pro (Trial) licenses.

Devices that have the Teams Rooms Pro license can access all the capabilities of their Teams Room devices. Devices with other Teams Rooms licenses can access a subset of those features. You can see which features are available to each license in Teams Rooms Basic and Teams Rooms Pro feature comparison.

Check the license of multiple Microsoft Teams Rooms devices

Checking licenses for Teams Room devices one at a time can be time consuming. To make this process easier, we're making available a sample script that checks the licenses of all your Teams Rooms devices. The script provides you with a list of the resource accounts that are associated with your Teams Rooms devices, organized by license type. Resource accounts with licenses that aren't supported with Teams Rooms devices are grouped together for your review. If resource accounts associated with Teams Rooms devices have an unsupported license type, you'll need to change it to a supported license before July 1, 2023.

Take a look at this short video to see how to use the example script to audit your licenses:

<#PSScriptInfo,  
.VERSION 0.24 
.GUID  
.AUTHOR Peter Lurie, Mark Hodge 
.COMPANYNAME Microsoft 
.COPYRIGHT (c) 2022-2023 Peter Lurie & Mark Hodge 
.TAGS Microsoft Teams Room System Surface Hub MEETING_ROOM for Resource Accounts 
.LICENSEURI https://creativecommons.org/licenses/by/4.0/?ref=chooser-v1 
.PROJECTURI  
.ICONURI  
.EXTERNALMODULEDEPENDENCIES  
.REQUIREDSCRIPTS  
.EXTERNALSCRIPTDEPENDENCIES  
.RELEASENOTES 
Version 0.23: Updated to improve support for CSV output  
Version 0.24: updating file/path UI 
#> 

<# 
.SYNOPSIS 
Reports out the list of all resource accounts that have assigned licenses, highlighting the ones with Teams Meeting Room Pro licenses in green 
.DESCRIPTION 
This script uses MgGraph modules to check for resource accounts and their licenses.  
.PARAMETER  
None 
.NOTES 
author: Peter Lurie 
created: 2022-05-10 
edited: 2023-03-01 
#>  

Function Get-SaveFilePath ([string]$initialDirectory) {
    #prompts for filename and path for exporting to CSV, if needed 

    Add-Type -AssemblyName System.Windows.Forms 
    $SaveFileDialog = New-Object System.Windows.Forms.SaveFileDialog 
    $SaveInitialPath = ".\" 
    $SaveFileName = "TeamsMeetingRoomLicenses.csv" 
    $SaveFileDialog.initialDirectory = $SaveInitialPath #Sets current starting path 
    $SaveFileDialog.filter = "CSV (*.csv)| *.csv"  #Restricts to CSV by default 
    
    $SaveFileDialog.FileName = $SaveFileName    #Default filename  
    
    $SaveFileDialog.ShowDialog() #actually asks for the filepath 
    return $SaveFileDialog.filename #Returns filepath for writing to CSV 
} 

Clear-Host 
Write-Host 
Write-Host "Welcome to Meeting Room License Checker." -ForegroundColor Green 
Write-Host 
Write-Host "This tool will look through your Exchange Online and AAD to find Resource Account Mailbox UPNs." 
Write-host "It will then report which resource accounts have Teams Room licenses, which have no license, and which have some other licenses" 
Write-host "This is ver 0.24."  
Write-Host 
 
#Setup for Graph 
Write-Host "Loading Microsoft Graph Modules"  
If (!(Get-Module -listavailable | Where-Object { $_.name -like "*Microsoft.Graph.Users*" })) {  
    Install-Module Microsoft.Graph.Users #-ErrorAction SilentlyContinue  
}  
Else {
    Import-Module Microsoft.Graph.Users #-ErrorAction SilentlyContinue  
}  
Try {
    write-host "Getting ready to connect to the Microsoft Graph"  
    Connect-MgGraph -Scopes "User.Read.All" 
    write-host "Connected successfully the Microsoft Graph" -ForegroundColor Green 
} 
Catch {
    write-host "Unable to connect to your Microsoft Graph Environment" -ForegroundColor Red 
} 

Write-Host  
Write-Host "Getting ready to connect to Exchange Online." -ForegroundColor Green 
If (!(Get-Module -listavailable | Where-Object { $_.name -like "*ExchangeOnlineManagement*" })) {
    Install-Module ExchangeOnlineManagement -ErrorAction SilentlyContinue  
}  
Else {
    Import-Module ExchangeOnlineManagement -ErrorAction SilentlyContinue  
}  
Try {
    write-host "Connecting to your Exchange Online instance" 
    $Prompt_EXOCreds = Connect-ExchangeOnline -ShowBanner:$false #Note if using GCC, DOD, or a sovereign cloud, see docs for this command for the correct -ExchangeEnvironmentName. Default is Commercial cloud 
    write-host "Connected successfully to your Exchange Online" -ForegroundColor Green 
} 
Catch {
    write-host "Unable to connect to your Exchange Online Environment"  -ForegroundColor Red 
}  

Write-Host  
Write-Host "Starting to search for Resource Account Mailbox UPNs and their licenses..." -ForegroundColor Green 
$StartElapsedTime = $(get-date) 
[System.Collections.ArrayList]$No_License = @() 
[System.Collections.ArrayList]$MTR_Premium_License = @() # Also includes MMR1 license 
[System.Collections.ArrayList]$MeetingRoom_License = @() #Teams Meeting Room Standard license 
[System.Collections.ArrayList]$MeetingRoomPro_License = @() #Optimal license 
[System.Collections.ArrayList]$MeetingRoomBasic_License = @() #Basic license does max out at 25 licenses/tenant 
[System.Collections.ArrayList]$MeetingRoomOther_License = @() #Licenses OTHER than what should be applied to a Teams Room Resource Account 
$Report = [System.Collections.Generic.List[Object]]::new() 

$Room_UPNs = get-mailbox | Where-Object { $_.recipientTypeDetails -eq "roomMailbox" } | Select-Object DisplayName, PrimarySmtpAddress, ExternalDirectoryObjectId 
Write-Host $Room_UPNs.Length " were found." -ForegroundColor Green 
Write-Host "Note that resource accounts can contain 0 or multiple licenses. As such, the total of all licenses discovered may be different than the number of resource accounts" -ForegroundColor Yellow 
Write-Host  

$i, $x = 0, $Room_UPNs.count #Setup for counting devices 
if ($null -eq $x) { $x = 1 } #run through the loop at least once to print results, otherwise will get a divide/0 error 
# Note that resource accounts can contain multiple license. As such, the sum of all licenses may exceed the number of resource accounts 

ForEach ($UPN in $Room_UPNs) { 
    $i++ 
    Write-Progress -activity "Searching for resource accounts with licenses..." -status "Scanned: $i of $x"  
    $UPN_license = Get-MgUserLicenseDetail -UserID $UPN.ExternalDirectoryObjectId | Select-Object -ExpandProperty SkuPartNumber 
    $temp = [pscustomobject]@{'DisplayName' = $UPN.DisplayName; 'UPN' = $UPN.PrimarySmtpAddress; 'Licenses' = $UPN_license -join ", " } 
    #pulls out the license from a UPN 

    if ($null -eq $UPN_license) { $No_License.add($temp) | Out-Null } #find resource accounts without licenses 

    if ($UPN_license -like "MTR_PREM*" -or $UPN_license -like "MMR_P*" ) { $MTR_Premium_License.add($temp) | Out-Null } #find resource accounts with legacy MTR Premium  
    if ($UPN_license -like "MEETING_ROOM*") { $MeetingRoom_License.add($temp) | Out-Null } #find resource accounts with legacy Teams Room Standard licenses 
    if ($UPN_license -like "Microsoft_Teams_Rooms_Pro*") { $MeetingRoomPro_License.add($temp) | Out-Null } #find resource accounts with meeting room pro licenses 
    if ($UPN_license -like "Microsoft_Teams_Rooms_Basic*") { $MeetingRoomBasic_License.add($temp) | Out-Null } #find resource accounts with meeting room basic licenses  

    if (!(($UPN_license -like "MEETING_ROOM*" ) -or ($UPN_license -like "Microsoft_Teams_Rooms_*" ) -or ($UPN_License -like "MTR_PREM") -or ($UPN_License -like "MMR_P1") -or ($null -eq $UPN_license) )) { $MeetingRoomOther_License.add($temp) | Out-Null }
    #If there are resource accounts that have other licenses, add them too. 

    $Report.Add($temp) #Creating the file for the CSV, if needed later 

    $temp = $null 
} 

Write-Progress -Completed -activity "Searching for resource accounts with licenses..."  

Write-Host 

Write-Host $No_License.count "Resource accounts without any licenses. (Typically these would be bookable rooms without any Teams Meeting technology or resource accounts yet to be licensed.)" -ForegroundColor Cyan 
$No_License | Sort-Object UPN | Format-Table  
Write-Host  
Write-Host  
Write-Host $MeetingRoom_License.count "resource accounts with Legacy Teams Room Standard licenses. (Typically, these licenses should be upgraded to Teams Room Pro at EA Renewal)." -ForegroundColor Yellow 
$MeetingRoom_License | Sort-Object UPN | Format-Table 
Write-Host  
Write-Host  
Write-Host $MTR_Premium.count "Resource accounts with Teams Room Premium or MMR license. (Typically, these licenses should be migrated to Teams Room Pro at EA Anniversary/Renewal)." -ForegroundColor Red 
$MTR_Premium | Sort-Object UPN | Format-Table 
Write-Host  
Write-Host  
Write-Host $MeetingRoomPro_License.count "Resource accounts with MTR Pro licenses." -ForegroundColor Green 
$MeetingRoomPro_License | Sort-Object UPN | Format-Table 
Write-Host  
Write-Host  
Write-Host $MeetingRoomBasic_License.count "Resource accounts with Teams Room System Basic licenses." -ForegroundColor Green 
$MeetingRoomBasic_License | Sort-Object UPN | Format-Table 
Write-Host  
Write-Host  
Write-Host $MeetingRoomOther_License.count "Resource accounts with licenses other than Teams Room System licenses. (Confirm if these licenses are actually needed)." -ForegroundColor Yellow 
$MeetingRoomOther_License | Sort-Object UPN | Format-Table 
Write-Host  
Write-Host  

$elapsedTime = $(get-date) - $StartElapsedTime 
$totalTime = "{0:HH:mm:ss}" -f ([datetime]$elapsedTime.Ticks) 
Write-Host "Processing took $totalTime." -ForegroundColor Green 
Write-Host  
Write-Host 
$answer = read-host -prompt "Do you want to export results to a CSV file? [y/N]" 
If ($answer.ToLower() -eq 'y' ) { 
    try { 
        $SaveMyFile = Get-SaveFilePath #Use Get-SaveFilePath function to prompt for filepath information 
        $Report | Sort-Object UPN | Export-CSV -Path $SaveMyFile[1] -NoTypeInformation  
        Write-Host "Results Saved." -ForegroundColor green 
    } 
    catch { 
        Write-Host "Unable to save CSV" -ForegroundColor red 
    } 
}  

Write-Host  
Write-host "Note: MgGraph and ExchangeOnline connections were not disconnected. Use Disconnect-ExchangeOnline and Disconnect-MgGraph if needed." -ForegroundColor yellow 
Write-Host  
Write-Host "Done" -ForegroundColor Green 

See which features require a Microsoft Teams Rooms Pro license

Features that require a Microsoft Teams Rooms Pro license can be identified by looking for the icon on a device's details page. If the device that's currently selected isn't assigned a Microsoft Teams Rooms Pro license, you can't perform the action and a prompt to upgrade is displayed.

Dialog showing Teams Rooms device restart options.