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

Service

Microsoft Teams

Published

Dec 6, 2024

Tag

Major change
Admin impact
Retirement

Summary

Starting January 2025, the Get-CsDialPlan cmdlet will be deprecated, along with the DialPlan attribute from Get-CsOnlineUser and LocationProfile attribute from Get-CsUserPolicyAssignment. Organizations using Microsoft Teams Phone services should prepare for these changes, which require no admin action but may necessitate updates to documentation and automations.

More information

There are important changes coming to a few Teams PowerShell cmdlets. Starting January 2025, we will be deprecating Get-CsDialPlan cmdlet. We will also be deprecating DialPlan attribute from Get-CsOnlineUser and LocationProfile attribute from Get-CsUserPolicyAssignment 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: Get-CsEffectiveTenantDialPlan.

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 Get-CsOnlineUser, Get-CsUserPolicyAssignment, Get-CsEffectiveTenantDialPlan.