MC720181 – Update to Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlet in the Teams PowerShell Module (archived)

Product:

Teams

Platform:

Online, World tenant

Status:

Change type:

Admin impact, Retirement

Links:

Details:

Summary:
The message announces an update to the Teams PowerShell Module. The LocationPolicy, OptionFlags, and VoicePolicy attributes will be retired from Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets. This change will be implemented in March 2024. Administrators will need to use the Teams PowerShell Module cmdlets to get LocationPolicy and VoicePolicy information. Detailed instructions are provided in the message.

Details:
We will be retiring LocationPolicy, OptionFlags and VoicePolicy attributes from Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets in the Teams PowerShell Module, If you are using these cmdlets to get LocationPolicy, VoicePolicy, or OptionFlags review the information below for additional details.
[When will this happen:]
The retirement is planned to happen in March 2024.

Change Category:
XXXXXXX ... free basic plan only

Scope:
XXXXXXX ... free basic plan only

Release Phase:

Created:
2024-02-28

updated:
2024-02-28

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

More Info URL

XXXXXXX ... free basic plan only

Direct effects for Operations**

- Impact on IT Operations
- Disruption in existing scripts and automation processes that rely on the Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets.
- Roles impacted: IT Administrators, DevOps Engineers
- Reference: [Microsoft Teams PowerShell Module](https://learn.microsoft.com/powershell/module/teams/get-csuserpolicyassignment)

- Impact on IT Services
- Potential service degradation if administrators are unable to retrieve LocationPolicy and VoicePolicy attributes, leading to misconfigurations in user settings.
- Roles impacted: Service Desk, IT Support Staff
- Reference: [Get-CsOnlineUser cmdlet](https://learn.microsoft.com/powershell/module/skype/get-csonlineuser)

- Impact on IT Users
- Users may experience issues with call routing and location-based features if policies are not correctly assigned due to the change in cmdlet outputs.
- Roles impacted: End Users, Business Units relying on Teams for communication
- Reference: [Microsoft Teams User Policies](https://learn.microsoft.com/en-us/microsoftteams/teams-policies)

- Impact on IT Administrators
- Increased workload for IT administrators to update documentation and training materials to reflect the new cmdlet usage and ensure compliance with the changes.
- Roles impacted: IT Administrators, Training Coordinators
- Reference: [Get-CsPhoneNumberAssignment cmdlet](https://learn.microsoft.com/powershell/module/teams/get-csphonenumberassignment)

- Dependencies and Interdependencies
- Changes may affect integrations with third-party applications that rely on Teams PowerShell cmdlets for user policy management, potentially leading to broader operational issues.
- Roles impacted: IT Architects, Integration Specialists
- Reference: [Microsoft Teams Integration](https://learn.microsoft.com/en-us/microsoftteams/platform/overview)

Opportunities**

- Transition to New Cmdlets
- Opportunity to train IT administrators on the new cmdlets (Get-CsPhoneNumberAssignment) to ensure smooth transition and continued access to LocationPolicy information.
- Roles: IT Administrators, Helpdesk Support
- Reference: [Microsoft Teams PowerShell Module Documentation](https://learn.microsoft.com/powershell/module/teams/get-csphonenumberassignment)

- Streamline Policy Management
- Review and update existing scripts and automation processes that rely on the retired attributes to minimize disruption and maintain operational efficiency.
- Roles: IT Operations, DevOps Engineers
- Reference: [Get-CsOnlineUser Documentation](https://learn.microsoft.com/powershell/module/skype/get-csonlineuser)

- Enhance User Experience
- Implement a communication plan to inform users about the changes and how it may affect their Teams experience, ensuring they are aware of any new processes or features.
- Roles: IT Communications Team, User Experience Designers
- Reference: [Change Management Best Practices](https://www.prosci.com/resources/articles/change-management-best-practices)

- Optimize Licensing Costs
- Assess current licensing agreements in light of the changes to identify any potential savings or adjustments needed based on the new cmdlet functionalities.
- Roles: IT Finance, Licensing Managers
- Reference: [Microsoft Licensing Overview](https://www.microsoft.com/en-us/licensing/default)

- Improve Documentation and Support Resources
- Update internal documentation and support resources to reflect the new cmdlet usage and provide troubleshooting guides for common issues that may arise post-transition.
- Roles: IT Documentation Specialists, Support Teams
- Reference: [Microsoft Teams Documentation](https://learn.microsoft.com/en-us/microsoftteams/teams-overview)

Potentional Risks**

XXXXXXX ... paid membership only