Microsoft Teams PowerShell Release Notes

This page provides the latest Teams PowerShell change log for both General Availability and Public Preview releases.

Release Notes

Note

-preview in the version column below represents updates to Teams PowerShell public preview.

Date Version Updates
December 2021 3.0.1-preview
  • Releases modernized versions of Grant-CsTeamsFilesPolicy and Remove-CsTeamsFilesPolicy. These are expected to work similar to their remoting counterparts. The modern versions will be gradually rolled out. So some tenants will see the older remoting version (until the rollout completes).
  • Releases [New|Set|Remove]-CsUserCallingDelegate cmdlets. These cmdlets will be eventually released in GA module. Releasing the trial version in preview module.
  • Releases [Get|Remove]-CsTeamsShiftsConnectionErrorReport cmdlets. These cmdlets will be eventually released in GA module. Releasing the trial version in preview module.
  • Releases Get-CsTeamsShiftsConnectionOperation cmdlet. This cmdlet will be eventually released in GA module. Releasing the trial version in preview module.
  • Releases New-CsTeamsShiftsConnectionBatchTeamMap cmdlet. This cmdlet will be eventually released in GA module. Releasing the trial version in preview module.
  • Releases Remove-CsTeamsShiftsScheduleRecord cmdlet. This cmdlet will be eventually released in GA module. Releasing the trial version in preview module.
  • November 2021 3.0.0
  • Soon Microsoft Teams PowerShell Module versions in the 3.x.x series will be the only versions supported. All earlier versions will be on the deprecation path.
  • [BREAKING CHANGE] Get-CsOnlineUser and Get-CsOnlineVoiceUser: The following changes apply for TeamsOnly tenants:
    • These cmdlets have now been migrated from the earlier implementation to the newer APIs.
    • (Using -Identity parameter): Attributes that are no longer relevant for Teams have been deprecated for TeamsOnly Tenants. Some attributes have also been renamed/replaced—see Get-CsOnlineUser and Get-CsOnlineVoiceUser.
    • Get-CsOnlineUser (with -Filter parameter): Formatting for filtering based on AssignedPlans and EnterpriseVoice has been modified. Filterable attributes have also been temporarily limited (based on usage) for TeamsOnly Users—see Get-CsOnlineVoiceUser.
    • These cmdlets will be gradually rolled out and some tenants will not experience these changes until the rollout is complete by the end of CY21.
  • [BREAKING CHANGE] Get-CsTenant: Attributes that are no longer relevant in the Teams world have been deprecated for TeamsOnly tenants—see Get-CsTenant.
  • Releases modernized versions of all 75+ Grant-Cs<Name>Policy cmdlets (all parameter sets). These are expected to work similar to their remoting counterparts. The modern versions will be gradually rolled out, so some tenants will see the earlier remoting version (until the rollout completes).
  • Releases modernized versions of all 75+ Remove-Cs<Name>Policy cmdlets. These are expected to work similar to their remoting counterparts. The modern versions will be gradually rolled out, so some tenants will see the earlier remoting version (until the rollout completes).
  • Releases [Set|Remove]-CsPhoneNumberAssignment cmdlets. These cmdlets will be gradually rolled out, so some tenants will get an error message referencing the existing cmdlets that they can use (until the rollout completes).
  • Releases new parameter EnhancedEmergencyServiceDisclaimer for [Set|New]-CsTeamsEmergencyCallingPolicy cmdlet.
  • Releases [Get|Add|Remove]-TeamChannelUser cmdlets.
  • Releases Export-CsOnlineAudioFile cmdlet.
  • Fixes error handlings for [Get|Import|Remove]-CsOnlineAudioFile cmdlets.
  • Fixes for Get-Team error handling. Outputs the error message if fetching teams data fails.
  • Fixes for Connect-MicrosoftTeams - AccessTokens the difference in expiration time is increased.
  • November 2021 2.6.2-preview
  • Releases modernized versions of all 75+ Grant-Cs<Name>Policy cmdlets (all parameter sets). These are expected to work similarly to their remoting counterparts. The modern versions will be gradually rolled out, tenants that aren't flighted will see the older remoting version.
  • Releases modernized versions of all 75+ Remove-Cs<Name>Policy cmdlets. These are expected to work similarly to their remoting counterparts. The modern versions will be gradually rolled out, tenants that aren't flighted will see the older remoting version.
  • Releases Set-CsUserCallingSettings cmdlet. This cmdlet will be eventually released in GA module. Releasing the trial version in preview module.
  • Releases Export-CsOnlineAudioFile cmdlet.
  • Fixes error handlings for [Get|Import|Remove]-CsOnlineAudioFile cmdlets.
  • October 2021 2.6.1-preview
  • Releases [Set|Remove]-CsPhoneNumberAssignment cmdlets. These cmdlets will be gradually rolled out. So some tenants will get an error message referencing the existing cmdlets they can use (until the rollout completes).
  • Releases Get-CsOnlineTelephoneNumberCountry and Get-CsOnlineTelephoneNumberType cmdlets.
  • Releases new parameter EnhancedEmergencyServiceDisclaimer for [Set|New]-CsTeamsEmergencyCallingPolicy cmdlet.
  • Releases Get-CsUserCallingSettings cmdlet. This cmdlet will be eventually released in GA module. Releasing the trial version in preview module.
  • September 2021 2.6.0
  • Fixes the bug where MicrosoftTeams module lookup failed if made a nested module of another custom PowerShell module. Now, MicrosoftTeams cmdlets are available even if it's a nested module of another module.
  • Releases [Get|New|Complete|Clear]-CsOnlineTelephoneNumberOrder cmdlets.
  • Releases Get-CsOnlineTelephoneNumberCountry and Get-CsOnlineTelephoneNumberType cmdlets.
  • Releases new parameters for these cmdlets : Get-CsOnlineApplicationInstance, New-CsExternalAccessPolicy, New-CsTeamsAppSetupPolicy, New-CsTeamsCallingPolicy, New-CsTeamsCallParkPolicy, New-CsTeamsMeetingPolicy, New-CsTeamsMessagingPolicy, Set-CsTeamsAppSetupPolicy, Set-CsTeamsCallParkPolicy, Set-CsTeamsGuestMessagingConfiguration, Set-CsTeamsMeetingPolicy, Set-CsTenantFederationConfiguration, Set-CsExternalAccessPolicy, Set-CsTeamsCallingPolicy.
  • Fixes the failure that occurred when retrying login with Connect-MicrosoftTeams after an incorrect sign-in attempt.
  • Updates to make the module's release notes available in PowerShell Gallery for each new version.
  • September 2021 2.5.2-preview
  • Note: Starting from this version, the release notes will also be published on PowerShell Gallery along with the module itself to reduce the delay in availability of release notes.
  • Releases [Get|Set|Grant|New|Remove]-CsTeamsEnhancedEncryptionPolicy cmdlets.
  • Removes [Get|Set|New|Remove]-CsTenantBlockedNumberExceptionPattern cmdlets.
  • Fixes the bug where the Microsoft Teams module lookup failed if it was made a nested module of another custom PowerShell module. Now, Microsoft Teams cmdlets are available even if its a nested module of another module.
  • Releases [Get|New|Complete|Clear]-CsOnlineTelephoneNumberOrder cmdlets.
  • Releases Get-CsOnlineTelephoneNumberCountry and Get-CsOnlineTelephoneNumberType cmdlets.
  • Fixes the failure that occurred when retrying sign-in with Connect-MicrosoftTeams after an incorrect sign-in attempt.
  • Fixes Add-TeamChannelUser and Remove-TeamChannelUser failing for a private channel.
  • August 2021 2.5.1
  • The Access Token login for Connect-MicrosoftTeams now uses a unified token array instead of separate parameters for each resource-specific token. More details can be found here: Connect-MicrosoftTeams.
  • The interactive login failure of Connect-MicrosoftTeams in Cloudshell has been fixed. It now defaults to using the logged-in identity of the user instead of prompting for re-authentication.
  • TeamsUnassignedNumberTreatment cmdlets are now available.
  • Get-CsOnlineDialInConferencingBridge and Set-CsOnlineDialInConferencingBridge cmdlets have now been migrated from the older implementation to the newer APIs.
  • Modernized versions of Get-CsTenant and Get-CsOnlineUser (with -identity parameter only) have been released. They no longer emit deprecated properties and have some formatting changes compared to their remoting counterparts.
  • Note: The New-Team related updates have been reverted from 2.5.0 and the previous version has been provided so as to avoid any breaking changes.
  • July 2021 2.4.1-preview
  • Grant cmdlets changes now available.
  • New Voice related cmdlets are released.
  • Removal of certificate thumbprint authentication for -Cs* cmdlets.
  • Logging fix for logging files of all cmdlets.
  • Fixes issues with *TeamChannelUser cmdlets.
  • June 2021 2.4.0-preview
  • Preview only release of modernized versions of Get-CsTenant, Get-CsOnlineUser (with -identity parameter only), Get-CsOnlineDialInConferencingLanguagesSupported, and Import-CsOnlineAudioFile.
  • Modernized versions of Get-CsOnlineDialInConferencingLanguagesSupported and Import-CsOnlineAudioFile are expected to work similar/same to their remoting counterparts.
  • Modernized versions of Get-CsTenant and Get-CsOnlineUser (when run with -identity parameter) don't emit deprecated properties.
  • Modernized versions of Get-CsTenant and Get-CsOnlineUser (when run with -identity parameter) have some formatting changes when compared to their remoting counter parts.
  • Releases [Get|Set|Grant|New|Remove]-CsTeamsAudioConferencingPolicy cmdlets.
  • Releases Get-CsOnlineAudioFile and Remove-CsOnlineAudioFile cmdlets.
  • Set-TeamTargetingHierarchy, Remove-TeamTargetingHierarchy, Get-TeamTargetingHierarchyStatus are now available for GCC customers.
  • Fixes the endpoint called by the Get-TeamTargetingHierarchyStatus command.
  • May 2021 2.3.2-preview
  • Support for AccessToken login with Connect-MicrosoftTeams. Added -AccessTokens parameter that accepts the array of token. MSGraph and Teams resource token are required when using the AccessTokens parameter.
  • Removed AadAccessToken and MsAccessToken parameters.
  • May 2021 2.3.1
  • Update from .NETCore 2.1 to 3.1
  • Added cmdlet to get multi-geo region for users and groups
  • Fixes for integrated windows authentication to use -AccountId with Connect-MicrosoftTeams
  • TeamsCallHoldPolicy cmdlets are now available
  • Updates to input parameters and output formats of many commands
  • Fixes large latency issue while remoting commands
  • GA custom package features
  • April 2021 2.2.0-preview
  • Fixes for integrated Windows authentication to use -AccountId with Connect-MicrosoftTeams.
  • Added cmdlet to get details of total change notification events that can be sent to users.
  • Added cmdlet to get multi-geo region for users and groups.
  • Handling of values passed to TeamsEnvironment name was case sensitive. This has been fixed.
  • Major refactor of remote session management within the module to facilitate unit tests. There should be no functional change for tenant admins.
  • April 2021 2.1.0-preview
  • Fixed output formatting of some remoting cmdlets (for example, Get-CsTeamsNetworkRoamingPolicy, Get-CsTeamsMeetingPolicy, Get-CsTeamsMessagingPolicy, and more).
  • Updated parameter list of policy management cmdlets.
  • March 2021 2.0.0
  • Uses MSAL for authentication & authorization
  • Connect-MicrosoftTeams is the entry point for all cmdlets.
  • New-csOnlineSession is no longer available. It has been replaced with Connect-MicrosoftTeams.
  • Enable-csonlinesessionforreconnection is no longer required. The feature has been natively implemented in Teams PowerShell Module.
  • Refactored Policy Package cmdlets and adds group package assignment
  • Significant performance enhancements for Get-Team cmdlet
  • Improved logging and debugging option for existing cmdlets
  • Added template management cmdlets
  • Deprecation of New-CsOnlineSession
  • February 2021 1.1.11-preview
  • Added template management cmdlets
  • Mezzo and batching enhancements for Get-Team cmdlet
  • Improved logging and debugging option for existing cmdlets
  • Refactored Policy Package cmdlets
  • December 2020 1.1.10-preview
  • Updates to New-team cmdlet with increased retries and sleep duration
  • December 2020 1.1.9-preview
  • Updates for Skype for Business Online Integration
  • Fix for the duplicate prompt with Connect-Microsoft Teams
  • November 2020 1.1.8-preview
  • Adds custom policy package cmdlets
  • Fixes for the targeting hierarchy upload commands
  • November 2020 1.1.7-preview
  • Uses MSAL for authentication & authorization
  • Refactored Policy Package cmdlets and adds group package assignment
  • Refactored targeting hierarchy upload commands to use an asynchronous model
  • User will be prompted twice during initial authentication when they do not use the -credential parameter. Users can pass credentials using the -credential parameter to avoid a duplicate prompt. This behavior will be fixed in the next release.
  • September 2020 1.1.6
  • Skype for Business Online Connector integration
  • September 2020 1.1.5-preview
  • Skype for Business Online Connector integration
  • July 2020 1.1.4
  • Added group policy assignment cmdlets
  • June 2020 1.1.3-preview
  • Skype for Business Online Connector integration
  • Get-Team optimizations
  • Enhanced reliability
  • June 2020 1.0.7
  • Added Cmdlet preloading
  • .NET Framework optimizations
  • April 2020 1.0.6
  • Authenticode and assembly signing
  • Added Get-CsPolicyPackage
  • Added Get-CsUserPolicyPackage
  • Added Get-CsUserPolicyPackageRecommendation
  • Added Grant-CsUserPolicyPackage
  • Added New-CsBatchPolicyPackageAssignmentOperation
  • Added Set-TeamArchivedState
  • Added Set-TeamPicture
  • Removed Get-TeamHelp
  • March 2020 1.0.5
  • Added New-CsBatchPolicyAssignmentOperation
  • Feb 2020 1.0.4
  • Get-Team optimizations
  • Teams PowerShell Overview

    Installing Teams PowerShell

    Managing Teams with Teams PowerShell

    Microsoft Teams cmdlet reference

    Skype for Business cmdlet reference