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
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.
  • Fixes Add-TeamChannelUser and Remove-TeamChannelUser failing for private channel.
  • Updates to make the module's release notes available in PowerShell Gallery for each new version.
  • September 2021 2.5.2
  • 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.
  • 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