check before: 2025-02-15
Product:
Teams
Platform:
Online, World tenant
Status:
Change type:
Admin impact, Retirement, Updated message
Links:
Details:
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.
Details:
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.
Change Category:
XXXXXXX ... free basic plan only
Scope:
XXXXXXX ... free basic plan only
Release Phase:
Created:
2024-12-07
updated:
2025-03-06
Task Type
XXXXXXX ... free basic plan only
Docu to Check
XXXXXXX ... free basic plan only
MS How does it affect me
XXXXXXX ... free basic plan only
MS Preperations
XXXXXXX ... free basic plan only
MS Urgency
XXXXXXX ... free basic plan only
MS workload name
XXXXXXX ... free basic plan only
summary for non-techies**
XXXXXXX ... free basic plan only
Direct effects for Operations**
Deprecation of Cmdlets
Administrators will lose the ability to use Get-CsDialPlan, Get-CsOnlineUser, and Get-CsUserPolicyAssignment cmdlets, impacting their ability to manage dial plans and user policies effectively.
- roles: Administrators, IT Support
- references: https://learn.microsoft.com/powershell/module/teams/get-csdialplan?view=teams-ps, https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps
Documentation Updates
Without preparation, administrators may fail to update documentation and automation scripts, leading to confusion and potential errors in user management.
- roles: Administrators, Documentation Specialists
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps, https://learn.microsoft.com/en-us/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps
User Experience Disruption
Users may experience disruptions in Teams Phone services if administrators are unprepared for the changes, leading to potential service outages or misconfigurations.
- roles: End Users, Help Desk
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csdialplan?view=teams-ps, https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps
Increased Support Tickets
The lack of preparation may lead to an increase in support tickets as users encounter issues related to the deprecated cmdlets and their functionalities.
- roles: Help Desk, IT Support
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps, https://learn.microsoft.com/en-us/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps
Automation Failures
Existing automation scripts relying on the deprecated cmdlets will fail, causing delays in processes and potential operational inefficiencies.
- roles: Developers, Administrators
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csdialplan?view=teams-ps, https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps
Configutation Options**
XXXXXXX ... paid membership only
Potentional Risks**
XXXXXXX ... paid membership only
IT Security**
XXXXXXX ... paid membership only
explanation for non-techies**
XXXXXXX ... free basic plan only
** AI generated content. This information must be reviewed before use.
a free basic plan is required to see more details. Sign up here
A cloudsocut.one plan is required to see all the changed details. If you are already a customer, choose login.
If you are new to cloudscout.one please choose a plan.
change history
| Date | Property | old | new |
| 2025-03-06 | MC Last Updated | 01/15/2025 22:33:46 | 2025-03-05T17:12:34Z |
| 2025-03-06 | MC Messages | Updated January 15, 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 late February 2025. 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. | 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. |
| 2025-03-06 | MC End Time | 04/07/2025 09:00:00 | 2025-04-28T09:00:00Z |
| 2025-03-06 | MC Summary | The deprecation of Get-CsDialPlan, Get-CsOnlineUser, and Get-CsUserPolicyAssignment cmdlets in Teams PowerShell Module is delayed to mid-February 2025, with completion by late February. Administrators should stop using DialPlan and LocationProfile attributes and prepare for the change. No admin action is required for the update. | 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. |
| 2025-01-16 | MC 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. https://learn.microsoft.com/en-us/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps https://learn.microsoft.com/en-us/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-csdialplan?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-csonlineuser?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps | 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 https://learn.microsoft.com/en-us/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps https://learn.microsoft.com/en-us/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-csdialplan?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-cseffectivetenantdialplan?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-csonlineuser?view=teams-ps https://learn.microsoft.com/powershell/module/teams/get-csuserpolicyassignment?view=teams-pst |
| 2025-01-16 | MC MessageTagNames | Admin impact, Retirement | Updated message, Admin impact, Retirement |
| 2025-01-16 | MC 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. | The deprecation of Get-CsDialPlan, Get-CsOnlineUser, and Get-CsUserPolicyAssignment cmdlets in Teams PowerShell Module is delayed to mid-February 2025, with completion by late February. Administrators should stop using DialPlan and LocationProfile attributes and prepare for the change. No admin action is required for the update. |
| 2025-01-16 | MC Last Updated | 12/07/2024 00:38:47 | 2025-01-15T22:33:46Z |
| 2025-01-16 | MC Messages | 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. | Updated January 15, 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 late February 2025. 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. |
| 2025-01-16 | MC How Affect | 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. | 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 |
| 2025-01-16 | MC End Time | 03/31/2025 09:00:00 | 2025-04-07T09:00:00Z |
Last updated 2 months ago
