Microsoft Teams PowerShell Release Notes
5 minutes to read
In this article
This page provides the latest Teams PowerShell change log for both General Availability and Public Preview releases.
-preview in the version column below represents updates to Teams PowerShell public preview.
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.
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.
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.
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.
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.
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.
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
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.
Fixed output formatting of some remoting cmdlets (for example, Get-CsTeamsNetworkRoamingPolicy, Get-CsTeamsMeetingPolicy, Get-CsTeamsMessagingPolicy, and more). Updated parameter list of policy management cmdlets.
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
Added template management cmdlets Mezzo and batching enhancements for Get-Team cmdlet Improved logging and debugging option for existing cmdlets Refactored Policy Package cmdlets
Updates to New-team cmdlet with increased retries and sleep duration
Updates for Skype for Business Online Integration Fix for the duplicate prompt with Connect-Microsoft Teams
Adds custom policy package cmdlets Fixes for the targeting hierarchy upload commands
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.
Skype for Business Online Connector integration
Skype for Business Online Connector integration
Added group policy assignment cmdlets
Skype for Business Online Connector integration Get-Team optimizations Enhanced reliability
Added Cmdlet preloading .Net Framework optimizations
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
Teams PowerShell Overview
Installing Teams PowerShell
Managing Teams with Teams PowerShell
Microsoft Teams cmdlet reference
Skype for Business cmdlet reference