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.

近日公開予定: コマンドレットの範囲 Get-CsOnlineUser を拡大して、Microsoft Teams PowerShell モジュールのライセンスのないすべてのユーザーを含めます。また、Teams 管理センター (TAC) の [ユーザーの管理] ページの範囲を拡張して、ライセンスのないすべてのユーザーを含めます。

[これがいつ起こるか:]

今後の Teams PowerShell モジュール バージョン 6.1.1 プレビュー (2024 年 4 月中旬に予定) から更新 Get-CsOnlineUser されます。 

一般提供 (全世界): 2024 年 4 月下旬に、既存のすべての Teams PowerShell モジュール バージョンと TAC の [ユーザーの管理] ページでコマンドレットへの Get-CsOnlineUser 変更のロールアウトを開始し、2024 年 5 月中旬までに完了する予定です。

[これが組織に及ぼす影響:]

• Teams 管理センターの [ ユーザーの管理 ] ページを使用する場合:
  • ロールアウト前は、有効な Teams ライセンスを持たないライセンスのないユーザーは、ライセンスの削除後 30 日間のみ出力に表示されていました。ロールアウト後、Teams 管理センターの [ユーザーの管理] ページには、最初の 30 日後にライセンスのないユーザーが表示され、有効な Teams ライセンスを持っていなかったライセンスのないユーザーも含まれます。
• パラメーターを-identity指定せずに Teams PowerShell モジュールでコマンドレットを使用する場合Get-CsOnlineUser、次の更新プログラムが導入されています。
  • ロールアウト前は、有効な Teams ライセンスを持っていないライセンスのないユーザーは、ライセンスの削除後 30 日間、コマンドレットの Get-CsOnlineUser 出力に表示されていました。 ロールアウト後、 Get-CsOnlineUser 最初の 30 日後にライセンスのないユーザーが表示され、有効な Teams ライセンスを持っていなかったライセンスのないユーザーも含まれます。
  • 値は AccountType に変更され、有効な Teams ライセンスを持たないユーザーが含まれます (例外: Guest、SfbOnPremUser、、ResourceAccount)。IneligibleUser Unknown
  • フィルターIneligibleUserを使用してAccountType、出力からasを持つAccountTypeユーザーを除外できます。
    • 例えば： Get-CsOnlineUser -Filter {AccountType -ne 'IneligibleUser'}
• をパラメーターと共に-identity使用するとGet-CsOnlineUser、次の更新が導入されます。
  • またUPN、 AliasSIP Address -identity

詳細については、ドキュメントを参照してください: Get-CsOnlineUser (MicrosoftTeamsPowerShell) |Microsoft Learn (英語)

[準備に必要なこと:]

これらの変更について理解し、必要に応じて、既存のスクリプトに対応する更新を行って、これらの更新の利点を利用することをお勧めします。

このロールアウトは、管理者のアクションを必要とせずに、指定された日付までに自動的に行われます。この変更についてユーザーに通知し、必要に応じて関連ドキュメントを更新することをお勧めします。