SHD / MC Checker

MC720181 | Update to Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlet in the Teams PowerShell Module



MC720181 | Update to Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlet in the Teams PowerShell Module

Classification planForChange
Last Updated 02/28/2024 00:17:48
Start Time 02/28/2024 00:17:24
End Time 05/05/2025 07:00:00
Message Content

We will be retiring LocationPolicy, OptionFlags and VoicePolicy attributes from Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets in the Teams PowerShell Module, If you are using these cmdlets to get LocationPolicy, VoicePolicy, or OptionFlags review the information below for additional details.

[When will this happen:]

The retirement is planned to happen in March 2024.

[How this will affect your organization:]

When this change is implemented:

  • Administrators will no longer see LocationPolicy attribute in the output of the Get-CsOnlineUser cmdlet in Teams PowerShell Module version 6.1.0 (planned to be released on 15th March 2024) and any later versions. Whereas for older Teams PowerShell Module versions (<6.1.0) LocationPolicy will no longer be populated starting from 20th March 2024.
  • Administrators will no longer see LocationPolicy and VoicePolicy attributes in the output of the Get-CsUserPolicyAssignment cmdlet in Teams PowerShell Module version 6.1.0 (planned to be released on 15th March 2024) and any later versions. Whereas for older Teams PowerShell Module versions (<6.1.0) LocationPolicy and VoicePolicy will no longer be populated starting from 20th March 2024.
  • Administrators will see OptionFlags attribute as empty in the output of the Get-CsOnlineUser cmdlet in all existing Teams PowerShell Module versions (<=6.1.0) and any new versions (>6.1.0) that releases after March 20th, 2024.

[What you need to do to prepare:]

When this change is implemented,

  • Administrators will no longer be able to get the LocationPolicy and OptionFlags from Get-CsOnlineUser cmdlet. Instead, administrators will need to use the Teams PowerShell Module cmdlets: Get-CsPhoneNumberAssignment -IsoCountryCode to get the LocationPolicy information. It’s important to note that other details besides EnterpriseVoiceEnabled, previously found in OptionFlags, are no longer relevant for Teams. Administrators can still utilize the EnterpriseVoiceEnabled attribute in the output of the Get-CsOnlineUser cmdlet to get this information.
  • Administrators will no longer be able to get the LocationPolicy and VoicePolicy from Get-CsUserPolicyAssignment cmdlet. Instead, administrators will need to use the Teams PowerShell Module cmdlets: Get-CsPhoneNumberAssignment -IsoCountryCode to get the LocationPolicy information.

Detailed instructions on how to use these cmdlets are provided in Get-CsPhoneNumberAssignmentGet-CsOnlineUserGet-CsUserPolicyAssignment

Machine Translation

?Teams PowerShell モジュールのコマンドレットから Get-CsUserPolicyAssignment Get-CsOnlineUser LocationPolicy、OptionFlags、VoicePolicy 属性を廃止 します (これらのコマンドレットLocationPolicyを使用して、VoicePolicyまたはOptionFlags詳細については、以下の情報を確認してください)。

[これはいつ起こるのか:]

引退は2024年3月を予定しています。

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

この変更が実装されると、次のようになります。

  • 管理者は、Teams PowerShell モジュール バージョン 6.1.0 (2024 年 3 月 15 日にリリース予定) 以降のバージョンのコマンドレットのGet-CsOnlineUser出力に属性が表示されLocationPolicyなくなります。一方、古い Teams の場合、PowerShell モジュール バージョン (<6.1.0) LocationPolicy は 2024 年 3 月 20 日から設定されなくなります。
  • 管理者は、Teams PowerShell モジュール バージョン 6.1.0 (2024 年 3 月 15 日にリリース予定) 以降のバージョンのコマンドレットのGet-CsUserPolicyAssignment出力に属性VoicePolicyが表示されLocationPolicyなくなります。一方、古い Teams PowerShell モジュール バージョン (<6.1.0) LocationPolicy の場合、VoicePolicy2024 年 3 月 20 日以降は設定されなくなります。
  • 管理者には、2024 年 3 月 20 日以降にリリースされる既存のすべての Teams PowerShell モジュール バージョン (<=6.1.0) と新しいバージョン (>6.1.0) のコマンドレットのGet-CsOnlineUser出力で属性が空として表示されますOptionFlags

[準備に必要なこと:]

この変更が実装されると、

  • 管理者は、コマンドレットから Get-CsOnlineUser LocationPolicy を取得OptionFlagsできなくなります。代わりに、管理者は Teams PowerShell モジュール コマンドレットGet-CsPhoneNumberAssignment -IsoCountryCodeを使用して情報を取得するLocationPolicy必要があります。以前に にあった OptionFlags以外の詳細はEnterpriseVoiceEnabled、Teams には関連しなくなったことに注意することが重要です。管理者は、コマンドレットのGet-CsOnlineUser出力の属性を引き続き利用EnterpriseVoiceEnabledして、この情報を取得できます。
  • 管理者は、コマンドレットから and VoicePolicy from Get-CsUserPolicyAssignment を取得LocationPolicyできなくなります。代わりに、管理者は Teams PowerShell モジュール コマンドレットGet-CsPhoneNumberAssignment -IsoCountryCodeを使用して情報を取得するLocationPolicy必要があります。

これらのコマンドレットの使用方法の詳細については、「Get-CsPhoneNumberAssignmentGet-CsOnlineUser、  Get-CsUserPolicyAssignment」を参照してください