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

Originally posted by Microsoft Mar 30, 2024 Uncategorized 0 Comments

Microsoft Teams is expanding the scope of the Get-CsOnlineUser cmdlet and Teams Admin Center’s Manage Users Page to include all unlicensed users. The changes will roll out in late April 2024 and will affect the Teams admin center’s Manage Users Page and the Get-CsOnlineUser cmdlet in Teams PowerShell Module. Users who do not have a valid Teams license will be displayed in the output of the Get-CsOnlineUser cmdlet and the Teams admin center’s Manage Users Page after the initial 30 days and will also include unlicensed users who never had a valid Teams license. No admin action is required, but users may want to notify their users about this change and update any relevant documentation as appropriate.

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.

Message ID: MC761236