Microsoft Teams:Updates to Get-CsOnlineUser cmdlet in Teams PowerShell Module and Teams Admin Center’s Manage Users Page

Coming soon: We are expanding the scope of the Get-CsOnlineUser cmdlet to include all unlicensed users in the Microsoft Teams PowerShell Module. We are also expanding the scope of the Teams admin center (TAC) Manage users page to include all unlicensed users.

When this will happen:

We will update Get-CsOnlineUser starting with the upcoming Teams PowerShell Module versions 6.1.1 preview (scheduled for mid-April 2024). 

General Availability (Worldwide): We will begin rolling out the changes to the Get-CsOnlineUser cmdlet in all existing Teams PowerShell Module versions and TAC's Manage Users Page in late April 2024 and expect to complete by mid-May 2024.

How this will affect your organization:

• When using Teams admin center's Manage users page:
  • Before the rollout, unlicensed users who did not have a valid Teams license were displayed in the output only for 30 days after license removal. After the rollout, the Teams admin center's Manage users page will show unlicensed users after the initial 30 days and also include unlicensed users who never had a valid Teams license.
• When using the Get-CsOnlineUser cmdlet in Teams PowerShell Module without the -identity parameter, we are introducing these updates:
  • Before the rollout, unlicensed users who did not have a valid Teams license were displayed in the output of the Get-CsOnlineUser cmdlet for 30 days after license removal. After the rollout, Get-CsOnlineUser will show unlicensed users after the initial 30 days and also include unlicensed users who never had a valid Teams license.
  • The AccountType value Unknown is being renamed to IneligibleUser and will include users who do not have a valid Teams license (exceptions: Guest, SfbOnPremUser, and ResourceAccount).
  • You can exclude users with the AccountType as IneligibleUser from the output with the AccountType filter.
    • For example: Get-CsOnlineUser -Filter {AccountType -ne 'IneligibleUser'}
• When Get-CsOnlineUser is used with the -identity parameter, we are introducing these updates:
  • You can also use UPN, Alias, and SIP Address with the -identity parameter to obtain the information for a specific unlicensed user.

For more details, please refer to documentation: Get-CsOnlineUser (MicrosoftTeamsPowerShell) | Microsoft Learn

What you need to do to prepare:

We recommend you get familiar with these changes and if required, make corresponding updates to your existing scripts to utilize the benefits of these updates.

This rollout will happen automatically by the specified date with no admin action required. You may want to notify your users about this change and update any relevant documentation as appropriate.