19 Mar Upcoming Changes to Teams PowerShell Cmdlets: Get-CsOnlineUser and Get-CsUserPolicyAssignment

Upcoming Changes to Teams PowerShell Cmdlets: Get-CsOnlineUser and Get-CsUserPolicyAssignment

In the ever-evolving landscape of Microsoft Teams administration, staying abreast of updates to PowerShell cmdlets is crucial for effective management and automation. A recent announcement from Microsoft, communicated through MC720181, outlines significant changes to the Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets in the Teams PowerShell Module. This blog post aims to dissect these updates, providing clarity on what these changes entail and how they will impact Teams administration.

Key Changes to Teams PowerShell Cmdlets

Microsoft has announced the retirement of the LocationPolicy, OptionFlags, and VoicePolicy attributes from the Get-CsOnlineUser and Get-CsUserPolicyAssignment cmdlets. This move is part of Microsoft’s ongoing efforts to streamline Teams management and ensure that the PowerShell cmdlets remain relevant and useful for administrators.

Introduction of Get-CsPhoneNumberAssignment Cmdlet

To compensate for the retiring attributes, Microsoft introduces the Get-CsPhoneNumberAssignment cmdlet. This new cmdlet is designed to display information about one or more phone numbers, with various filters available for administrators to narrow down the results. The cmdlet returns results sorted by TelephoneNumber in ascending order, supporting both -Skip and -Top parameters for refined filtering.

Syntax and Usage

The Get-CsPhoneNumberAssignment cmdlet comes with a comprehensive set of parameters, allowing for detailed queries based on activation state, assignment category, capabilities, and more. This flexibility ensures that administrators can retrieve specific information tailored to their needs.

Impact of the Changes

The retirement of the LocationPolicy, VoicePolicy, and OptionFlags attributes signifies a shift towards more focused and relevant data retrieval methods in Teams administration. Starting in March 2024, with the release of Teams PowerShell Module version 6.1.0, these attributes will no longer be available in the output of the affected cmdlets. For users of older Teams PowerShell Module versions, these attributes will cease to be populated from March 20, 2024.

Preparing for the Transition

Administrators need to adjust their scripts and automation routines to accommodate these changes. Specifically, the Get-CsPhoneNumberAssignment -IsoCountryCode cmdlet should be used to retrieve LocationPolicy information. It’s important to note that details previously found under OptionFlags, such as EnterpriseVoiceEnabled, will still be accessible through the Get-CsOnlineUser cmdlet, ensuring that critical information remains available for Teams management.

These updates to the Teams PowerShell Module reflect Microsoft’s commitment to providing efficient and effective management tools for Teams administrators. By understanding and adapting to these changes, administrators can ensure a smooth transition and continue to leverage PowerShell for comprehensive Teams management.

For detailed instructions on utilizing the new and updated cmdlets, administrators are encouraged to review the documentation provided for Get-CsPhoneNumberAssignment, Get-CsOnlineUser, and Get-CsUserPolicyAssignment. These resources offer valuable insights into leveraging PowerShell for optimal Teams administration in light of the upcoming changes.

Stay tuned to official Microsoft communications and ensure your administration practices are aligned with the latest developments in Teams PowerShell cmdlets to maintain a robust and compliant Teams environment.