MC950879 - Update to Get-CsDialPlan, Get-CsOnlineUser, and Get-CsUserPolicyAssignment cmdlet in the Teams PowerShell Module

Updated March 5, 2025: We have updated the rollout timeline below. Thank you for your patience.

Based on customer feedback, we have decided to delay the deprecation of Get-CsDialPlan, Get-CsOnlineUser, and Get-CsUserPolicyAssignment cmdlet in the Teams PowerShell Module. We will gradually roll out this change to customers in mid-February 2025 and we expect to complete by mid-March 2025 (previously late February)

Here are more details on the change:

There are important changes coming to a few Teams PowerShell cmdlets. Starting mid-February 2025, we will be deprecating https://learn.microsoft.com/powershell/module/teams/get-csdialplan?view=teams-ps cmdlet. We will also be deprecating DialPlan attribute from https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps and LocationProfile attribute from https://learn.microsoft.com/en-us/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps cmdlet. If you are using DialPlan or LocationProfile attribute found in these cmdlets, please stop using them.

How this will affect your organization:

You are receiving this message because our reporting indicates your organization may be using Microsoft Teams Phone services. When this change is implemented,

Administrators will no longer be able to use Get-CsDialPlan cmdlet.

Administrators will no longer be able to get DialPlan from Get-CsOnlineUser cmdlets.

Administrators will no longer be able to get LocationProfile from Get-CsUserPolicyAssignment cmdlet.

To understand the effective dial plan please use: https://learn.microsoft.com/en-us/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps 

What you need to do to prepare:

This change will happen automatically, no admin action is required. Please notify your admins about this change, update relevant documentation and automations as appropriate.

Detailed instructions on these cmdlets are provided in:

Get-CsOnlineUser (MicrosoftTeamsPowerShell) | Microsoft Learn

Get-CsUserPolicyAssignment (MicrosoftTeamsPowerShell) | Microsoft Learn

Get-CsEffectiveTenantDialPlan (MicrosoftTeamsPowerShell) | Microsoft Learn