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

Service

Microsoft Teams

Published

Feb 28, 2024

Tag

Major change
Admin impact
Retirement

Summary

The message announces an update to the Teams PowerShell Module. The LocationPolicy, OptionFlags, and VoicePolicy attributes will be retired from Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets. This change will be implemented in March 2024. Administrators will need to use the Teams PowerShell Module cmdlets to get LocationPolicy and VoicePolicy information. Detailed instructions are provided in the message.

More information

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