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 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.
Details:
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.
Change Category:
XXXXXXX ... free basic plan only
Scope:
XXXXXXX ... free basic plan only
Release Phase:
Created:
2024-12-07
updated:
2025-01-16
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: Teams Administrator, IT Support Specialist
- 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" target="_blank" rel="nofollow noopener noreferrer">https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps
User Experience Disruption
Users may experience issues with dial plans and location profiles if administrators are unprepared for the change, leading to potential service disruptions.
- roles: End User, Teams Administrator
- 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
Documentation and Automation Updates
Existing documentation and automation scripts that rely on deprecated cmdlets will become obsolete, requiring immediate updates to avoid operational issues.
- roles: Documentation Specialist, DevOps Engineer
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csonlineuser?view=teams-ps" target="_blank" rel="nofollow noopener noreferrer">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
" target="_blank" rel="nofollow noopener noreferrer">https://learn.microsoft.com/en-us/powershell/module/teams/get-csuserpolicyassignment?view=teams-ps
Increased Support Requests
The change may lead to an increase in support requests from users facing issues due to the lack of access to dial plan and location profile information.
- roles: Help Desk Technician, IT Support Specialist
- 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-cseffectivetenantdialplan?view=teams-ps
Training Needs
There will be a need for additional training for administrators to adapt to the new cmdlets and understand the effective dial plan management.
- roles: Teams Administrator, Training Coordinator
- 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-csonlineuser?view=teams-ps" target="_blank" rel="nofollow noopener noreferrer">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-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 3 hours ago
