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 Januarymid-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.
DialPlan and LocationProfile are Microsoft internal use only attributes and we believe Microsoft Teams Phone administrators do not have any direct usage for these. To understand the effective dial plan please use: https://learn.microsoft.com/en-us/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps.
We will gradually roll out this change to customers in early January 2025, and we expect to complete by mid January 2025.
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 in:
Get-CsOnlineUser (MicrosoftTeamsPowerShell) | Microsoft Learn, Get-CsUserPolicyAssignment,
Get-CsUserPolicyAssignment (MicrosoftTeamsPowerShell) | Microsoft Learn
Get-CsEffectiveTenantDialPlan (MicrosoftTeamsPowerShell) | Microsoft Learn.