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

Service

Microsoft Teams

Last Updated

Mar 5, 2025

Published Dec 6, 2024

Tag

Major change
Updated message
Admin impact
Retirement

Summary

The deprecation of Get-CsDialPlan, Get-CsOnlineUser, and Get-CsUserPolicyAssignment cmdlets in the Teams PowerShell Module is delayed. Rollout will start mid-February 2025 and complete by mid-March 2025. Administrators should update documentation and automations accordingly. No admin action is required.

More information

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