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 represents updates to Teams PowerShell public preview.

Date Version Updates
December 2024 6.7.1-preview
  • Adds an optional parameter TargetType to Get-CsOnlineTelephoneNumberOrder cmdlet.
  • [BREAKING CHANGE] Changes output attribute from TelephoneNumber to TelephoneNumbers in Get-CsOnlineTelephoneNumberOrder cmdlet.
  • Releases New-CsOnlineTelephoneNumberReleaseOrder cmdlet.
  • Releases New-CsOnlineDirectRoutingTelephoneNumberUploadOrder cmdlet.
  • [BREAKING CHANGE] Replaces EnablePayAsYouGoSpendingLimits with EnableSpendLimits in [New|Set]-CsTeamsCallingPolicy.
  • [BREAKING CHANGE] Replaces PayAsYouGoSpendingUserLimit with CallingSpendUserLimit in [New|Set]-CsTeamsCallingPolicy.
  • Adds ShowTeamsCallsInCallLog to [New|Set]-CsTeamsCallingPolicy.
  • Releases [Get|Set]-CsTeamsMultiTenantOrganizationConfiguration cmdlets.
  • November 2024 6.7.0
  • Adds LobbyChats, NoiseSuppressionForDialInParticipants parameters to [New|Set]-CsTeamsMeetingPolicy.
  • Adds AIInterpreter, VoiceSimulationInInterpretation parameters to [New|Set]-CsTeamsCallingPolicy.
  • Adds RecordingForTownhall, RecordingForWebinar, TranscriptionForTownhall, TranscriptionForWebinar parameters to [New|Set]-CsTeamsEventsPolicy.
  • Adds FileTypeCheck, UrlReputationCheck parameters to [New|Set]-CsTeamsMessagingConfiguration.
  • Adds AllowedTrialTenantDomains parameter to [New|Set]-CsTenantFederationSettings.
  • Adds UserNameExtension parameter to [New|Set]-CsAutoAttendant cmdlets.
  • October 2024 6.6.1-preview
  • Adds AllowExtendedWorkInfoInSearch parameters to [New|Set]-CsTeamsMessagingPolicy.
  • Adds FederatedBilateralChats parameter to [New|Set]-CsExternalAccessPolicy.
  • Adds PinnedCallingBarApps parameter to [New|Set]-CsTeamsAppSetupPolicy.
  • Adds MessagingNotes parameter to Set-CsTeamsMessagingConfiguration.
  • Contains a new implementation of [Get|Set]-CsPrivacyConfiguration, [Get|Set|Remove|New]-CsTeamsNotificationAndFeedsPolicy. Functionality remains the same as previous implementation.
  • Releases [Get|Update]-M365UnifiedTenantSettings to get or update tenant level settings like DefaultApp, GlobalApp, PrivateApp and EnableCopilotExtensibility.
  • Adds AppInstallType, InstallForOperationType, InstallForUsers, InstallForGroups and InstallVersion parameters to Update-M365TeamsApp.
  • Adds InstalledFor output attribute to Get-M365TeamsApp & Get-AllM365TeamsApps.
  • Adds ApiVersion parameter to [Set|Remove]-TeamTargetingHierarchy and [Get]-TeamTargetingHierarchyStatus.
  • October 2024 6.6.0
  • Releases Export-CsAcquiredPhoneNumber cmdlet.
  • Releases Get-CsExportAcquiredPhoneNumberStatus cmdlet.
  • Releases [Get|Set|Remove|Grant|New]-CsTeamsAIPolicy cmdlets.
  • Releases [Get|Set]-CsTeamsEducationAssignmentsAppPolicy cmdlets.
  • Adds EnablePayAsYouGoSpendingLimits and PayAsYouGoSpendingUserLimit parameters to [New|Set]-CsTeamsCallingPolicy cmdlets.
  • Removes CreateBy attribute, updates datetime format for CreateAt and DownloadLinkExpiry attributes to UTC in Get-CsExportAcquiredPhoneNumberStatus cmdlet output.
  • August 2024 6.5.1-preview
  • Releases Export-CsAcquiredPhoneNumber cmdlet.
  • Releases Get-CsExportAcquiredPhoneNumberStatus cmdlet.
  • August 2024 6.5.0
  • [BREAKING CHANGE] Deprecates Set-CsOnlineDialInConferencingUserDefaultNumber cmdlet. More details in Set-CsOnlineDialInConferencingUserDefaultNumber.
  • Fixes mapping for postal code in Set-CsOnlineLisCivicAddress.
  • Releases [Get|Set]-CsTeamsExternalAccessConfiguration cmdlets.
  • Adds CaptchaVerificationForMeetingJoin parameter to the [New|Set]-CsTeamsMeetingPolicy cmdlets.
  • July 2024 6.4.1-preview
  • [BREAKING CHANGE] Deprecates Set-CsOnlineDialInConferencingUserDefaultNumber cmdlet. More details in Set-CsOnlineDialInConferencingUserDefaultNumber.
  • Fixes mapping for postal code in Set-CsOnlineLisCivicAddress.
  • June 2024 6.4.0
  • Adds ExternalAccessWithTrialTenants parameter to the Set-CsTenantFederationConfiguration cmdlet.
  • June 2024 6.3.0
  • [BREAKING CHANGE] Module is now supported only in PowerShell 7.2 & later, Windows PowerShell 5.1.
  • Adds AcsResourceId output attribute to the Get-CsOnlineApplicationInstance cmdlet.
  • Adds new parameter DefaultFileUploadAppId to [Set|New]-CsTeamsFilesPolicy cmdlets.
  • DefaultFileUploadAppId attribute is added in the Get-CsTeamsFilesPolicy output.
  • May 2024 6.2.2-preview
  • [BREAKING CHANGE] Module is now supported only in PowerShell 7.2 & later, Windows PowerShell 5.1.
  • Adds AcsResourceId output attribute to the Get-CsOnlineApplicationInstance cmdlet.
  • Adds new parameter DefaultFileUploadAppId to [Set|New]-CsTeamsFilesPolicy cmdlets.
  • DefaultFileUploadAppId attribute is added in the Get-CsTeamsFilesPolicy output.
  • May 2024 6.2.0
  • Releases [Get|Update]-M365TeamsApp, Get-AllM365TeamsApps Unified App Management cmdlets in GA.
  • Releases updates to Get-CsOnlineUser in commercial environments:
    • Unlicensed Users - Unlicensed users would show up in the output of Get-CsOnlineUser.
    • [BREAKING CHANGE] IneligibleUser - AccountType as Unknown is renamed to IneligibleUser. IneligibleUser includes users who don't have any valid Teams licenses (except Guest, SfbOnPremUser, ResourceAccount).
  • Adds new parameter AcsResourceId to [Set|Sync]-CsOnlineApplicationInstance cmdlets.
  • Fixes a bug in Get-CsPhoneNumberAssignment where ReverseNumberLookup was not getting correctly parsed.
  • April 2024 6.1.1-preview
  • Releases [Get|Update]-M365TeamsApp, Get-AllM365TeamsApps Unified App Management cmdlets in preview.
  • Releases updates to Get-CsOnlineUser in commercial environments:
    • Unlicensed Users - Unlicensed users would show up in the output of Get-CsOnlineUser.
    • [BREAKING CHANGE] IneligibleUser - AccountType as Unknown is renamed to IneligibleUser. IneligibleUser includes users who don't have any valid Teams licenses (except Guest, SfbOnPremUser, ResourceAccount).
  • Adds new parameter AcsResourceId to [Set|Sync]-CsOnlineApplicationInstance cmdlets.
  • April 2024 6.1.0
  • Adds BlockAllSubDomains parameter to the Set-CsTenantFederationConfiguration cmdlet.
  • Adds new parameters to [Set|New]-CsCallQueue cmdlets for configuring courtesy callback.
  • Releases [Get|New|Set|Grant]-CsTeamsMediaConnectivityPolicy cmdlets.
  • Releases [Get|New|Set|Grant]-CsTeamsWorkLocationDetectionPolicy cmdlets.
  • [BREAKING CHANGE] Removes LocationPolicy attribute from the output of Get-CsOnlineUser cmdlet. More details in Get-CsOnlineUser.
  • Releases [Get|New|Remove|Set|Grant]-CsTeamsRecordingRollOutPolicy cmdlets.
  • Contains a new implementation of [Get|Set]-CsTeamsEducationConfiguration. Functionality remains the same as previous implementation.
  • Adds new parameter SmsNotifications to TeamsMeetingPolicy cmdlets.
  • Adds new parameter UpdateParentInformation to TeamsEducationConfiguration cmdlets.
  • Adds new parameters to [Set|New]-CsCallQueue cmdlets for configuring response time service level threshold.
  • March 2024 6.0.1-preview
  • Adds BlockAllSubDomains parameter to the Set-CsTenantFederationConfiguration cmdlet.
  • Adds new parameters to [Set|New]-CsCallQueue cmdlets for configuring courtesy callback.
  • Releases [Get|New|Set|Grant]-CsTeamsMediaConnectivityPolicy cmdlets.
  • Releases [Get|New|Set|Grant]-CsTeamsWorkLocationDetectionPolicy cmdlets.
  • February 2024 6.0.0
  • Fixes expiration time related issues while using AccessTokens in Connect-MicrosoftTeams.
  • Releases Remove-CsUserLicenseGracePeriod cmdlet in private preview.
  • Adds IsInGracePeriod & GracePeriodExpiryDate to each plan in the AssignedPlan attribute in the Get-CsOnlineUser output.
  • January 2024 5.9.0
  • Adds support for managed identity based auth for *-Cs cmdlets using -Identity parameter in Connect-MicrosoftTeams in commercial environments. Few cmdlets that don't support application-based authentication aren't supported for this method as well.
  • Updates [Set|Get]-CsPhoneNumberAssignment to support user-ful/userless update in runtime routing options for telephone numbers.
  • Releases major updates for Get-CsOnlineUser in GCC High & DoD environments with significant performance improvements and new filtering capabilities to scenarios without the "-Identity" parameter:
    • Performance improvements especially with "-Filter" scenarios like using wildcard operator (*), OnPrem*, and Timestamp attributes.
    • Correct values start populating in the output for CountryAbbreviation, UserValidationErrors, WhenCreated.
    • These attributes are now enabled for filtering: Alias, City, Company, HostingProvider, UserValidationErrors, OnPremEnterpriseVoiceEnabled, OnPremHostingProvider, OnPremLineURI, OnPremSIPEnabled, SipAddress, SoftDeletionTimestamp, StateOrProvince, Street, TeamsOwnersPolicy, WhenChanged, WhenCreated, FeatureTypes, PreferredDataLocation, LastName.
    • These filtering operators are reintroduced into Get-CsOnlineUser:
      • "-like" operator now supports use of wildcard operators in 'contains' and 'ends with' scenarios. Example: Get-CsOnlineUser -Filter "DisplayName -like '*abc*'"
      • "-contains" can now be used for filtering on properties that are an array of strings like FeatureTypes, ProxyAddresses, and ShadowProxyAddresses. Example: Get-CsOnlineUser -Filter {FeatureTypes -contains "PhoneSystem"}
      • "-gt" (greater than), "-lt" (less than) can now be used for filtering all string properties. Example: Get-CsOnlineUser -Filter {UserPrincipalName -gt/-lt "abc"}
      • "-ge" (greater than or equal to), "-gt" (greater than), "-lt" (less than), "-le" (less than or equal to) can now also be used for filtering on policies. Example: Get-CsOnlineUser - Filter {ExternalAccessPolicy -ge "xyz_policy"}
    • Updates to type of users displayed:
      • Unlicensed Users - Unlicensed users would show up in the output of Get-CsOnlineUser.
      • Soft deleted users - These users are displayed in the output with SoftDeletionTimestamp set to a value.
      • Guest users are now available in the output.
      • [BREAKING CHANGE] IneligibleUser - AccountType as Unknown is renamed to IneligibleUser. IneligibleUser includes users who don't have any valid Teams licenses (except Guest, SfbOnPremUser, ResourceAccount).
  • Updates Set-CsTeamsMeetingConfiguration to support enabling or disabling anonymous meeting participants to receive surveys using FeedbackSurveyForAnonymousUsers parameter.
  • Removes unused DomainController parameter from [Set|Register|Unregister]-CsOnlineDialInConferencingServiceNumber, Set-CsOnlineDialInConferencingBridge & Set-CsOnlineDialInConferencingUser cmdlets.
  • December 2023 5.8.1-preview
  • Adds support for managed identity based auth for *-Cs cmdlets using -Identity parameter in Connect-MicrosoftTeams in commercial environments. Few cmdlets that don't support application-based authentication aren't supported for this method as well.
  • November 2023 5.8.0
  • Updates the Get-MultiGeoRegion cmdlet to provide PreferredDataLocation and LastMovementTimeStamp of User/Group. Also, the cmdlet is now supported without enablement of port 8653.
  • Fixes a bug in Set-Team cmdlet where setting GiphyContentRating wasn't working.
  • Adds ContentSharingInExternalMeetings and UseMicrosoftECDN parameters to [New|Set]-CsTeamsMeetingPolicy.
  • Adds NumberOfResultsToSkip parameter (which was deprecated earlier) to Get-CsOnlineLisLocation and Get-CsOnlineLisCivicAddress cmdlets.
  • October 2023 5.7.2-preview
  • Updates the Get-MultiGeoRegion cmdlet to provide PreferredDataLocation and LastMovementTimeStamp of User/Group. Also, the cmdlet is now supported without enablement of port 8653.
  • Fixes a bug in Set-Team cmdlet, where setting GiphyContentRating wasn't working.
  • Adds ContentSharingInExternalMeetings and UseMicrosoftECDN parameters to [New|Set]-CsTeamsMeetingPolicy.
  • October 2023 5.7.1
  • Fixes an issue introduced in versions 5.6.1-preview & 5.7.0, due to which Get-CsTeamsMeetingConfiguration cmdlet wasn't present in the module.
  • October 2023 5.7.0
  • Removes deprecated ExternalAccessPrefix and OptimizeDeviceDialing parameters from [New|Set]-CsTenantDialPlan cmdlets.
  • Fixes Get-CsTenantDialPlan cmdlet to return correct format of dial plan policy.
  • Adds AdministrativeUnitReference to Get-CsOnlineUser output. This attribute is currently populated in the commercial environments only.
  • Fixes an issue with Connect-MicrosoftTeams to display the relevant TenantId, when authenticated using Managed Service Identity.
  • Fixes the error in Sync-CsOnlineApplicationInstance output.
  • Contains a new implementation of [New|Get|Set|Remove|Grant]-CsTeamsVdiPolicy cmdlets. Functionality remains the same as previous implementation.
  • Adds NumberSource output attribute to the Get-CsPhoneNumberAssignment cmdlet.
  • Adds CreateCustomEmojis and DeleteCustomEmojis parameters to [New|Set]-CsTeamsMessagingPolicy.
  • Adds ParticipantNameChange and AutoRecording parameters to [New|Set]-CsTeamsMeetingPolicy.
  • Fixes a bug in Get-Team cmdlet where duplicate progress record was appearing.
  • Fixes token expiry issue with Get-Team cmdlet.
  • [BREAKING CHANGE] Due to an issue, Get-CsTeamsMeetingConfiguration cmdlet is missing in versions 5.6.1-preview & 5.7.0. This issue is fixed from version 5.7.1 onwards.
  • October 2023 5.6.1-preview
  • Removes deprecated ExternalAccessPrefix and OptimizeDeviceDialing parameters from [New|Set]-CsTenantDialPlan cmdlets.
  • Fixes Get-CsTenantDialPlan cmdlet to return correct format of dial plan policy.
  • Adds AdministrativeUnitReference to Get-CsOnlineUser output. This attribute is currently populated in the commercial environments only.
  • Fixes an issue with Connect-MicrosoftTeams to display the relevant TenantId, when authenticated using Managed Service Identity.
  • Fixes the error in Sync-CsOnlineApplicationInstance output.
  • [BREAKING CHANGE] Due to an issue, Get-CsTeamsMeetingConfiguration cmdlet is missing in versions 5.6.1-preview & 5.7.0. This issue is fixed from version 5.7.1 onwards.
  • September 2023 5.6.0
  • Updates [Set|Get]-CsPhoneNumberAssignment to support NetworkSiteId of unassigned numbers.
  • Fixes Get-CsTenantNetworkSite cmdlet error introduced in version 5.5.0.
  • Releases [Get|Set]-CsTeamsSipDevicesConfiguration cmdlets.
  • Releases New-CsSdgBulkSignInRequest, Get-CsSdgBulkSignInRequestStatus & Get-CsSDGBulkSignInRequestsSummary cmdlets in GA.
  • Releases [New|Get|Set|Remove]-CsTeamsCustomBannerText cmdlets.
  • Contains a new implementation of [Get|Set]-CsTeamsMeetingConfiguration. Functionality remains the same as previous implementation.
  • Adds new parameters CopyRestriction, CopilotWithoutTranscript, and VoiceIsolation to [New|Set]-CsTeamsMeetingPolicy cmdlets.
  • Fixes issues with pipeline input for Grant-Cs<PolicyName> cmdlets.
  • August 2023 5.5.1-preview
  • Updates [Set|Get]-CsPhoneNumberAssignment to support NetworkSiteId of unassigned numbers.
  • Fixes Get-CsTenantNetworkSite cmdlet error introduced in version 5.5.0.
  • Releases [Get|Set]-CsTeamsSipDevicesConfiguration cmdlets.
  • August 2023 5.5.0
  • Releases New-CsTeamsHiddenTemplate cmdlet.
  • Releases [New|Get|Set|Remove]-CsTeamsTemplatePermissionPolicy cmdlets.
  • Adds a new parameter -IncludePhoneNumbers to Get-CsTenantNetworkSite.
  • [BREAKING CHANGE] Deprecates EnableShiftPresence parameter from TeamsShiftsPolicy.
  • Contains a new implementation of [Get|Set]-CsTeamsUpgradeConfiguration, [Get|Set|Remove|New]-CsTeamsComplianceRecordingPolicy, [Get|Set|Remove|New]-CsTeamsComplianceRecordingApplication, New-CsTeamsComplianceRecordingPairedApplication. Functionality remains the same as previous implementation.
  • Releases [New|Get|Set|Remove|Grant]-CsTeamsSharedCallingRoutingPolicy cmdlets.
  • [BREAKING CHANGE] Get-CsTenantNetworkSite cmdlet has an unintended issue and throws error "Provided type NetworkSiteType is not valid". Use versions 5.5.0 or later to mitigate this issue.
  • July 2023 5.4.0
  • Fixes the issue with few scenarios like Set-CsUser, OnPrem to Cloud migrations etc. These scenarios had an unintended issue in versions 5.3.0, 5.2.1-preview & 5.3.1-preview where errors like "Forest header can’t be null" were seen.
  • Adds State output attribute to Get-CsTeamsShiftsConnectionTeamMap cmdlet.
  • Releases Remove-CsTeamsShiftsConnection cmdlet.
  • Updates [Set|Get]-CsPhoneNumberAssignment to support AssignmentCategory.
  • Updates Set-CsPhoneNumberAssignment to support location update of unassigned numbers.
  • July 2023 5.3.1-preview
  • [BREAKING CHANGE] Few cmdlets (like Set-CsUser) have an unintended issue in versions 5.3.0, 5.2.1-preview & 5.3.1-preview where errors like "Forest header can’t be null" is seen. Use 5.4.0 or later to mitigate this issue.
  • Adds State output attribute to Get-CsTeamsShiftsConnectionTeamMap cmdlet.
  • Releases Remove-CsTeamsShiftsConnection cmdlet.
  • Updates [Set|Get]-CsPhoneNumberAssignment to support AssignmentCategory.
  • Updates Set-CsPhoneNumberAssignment to support location update of unassigned numbers.
  • June 2023 5.3.0
  • [BREAKING CHANGE] Few cmdlets (like Set-CsUser) have an unintended issue in versions 5.3.0, 5.2.1-preview & 5.3.1-preview where errors like "Forest header can’t be null" is seen. Use 5.4.0 or later to mitigate this issue.
  • [BREAKING CHANGE] Adds State parameter & output attribute to [New|Get|Set|Update]-CsTeamsShiftsConnection and [New|Get|Set|Update]-CsTeamsShiftsConnectionInstance cmdlets.
  • Releases [New|Get|Set|Remove|Grant]-CsTeamsMeetingTemplatePermissionPolicy cmdlets.
  • Releases Get-CsTeamsMeetingTemplateConfiguration cmdlet.
  • Releases Get-CsTeamsFirstPartyMeetingTemplateConfiguration cmdlet.
  • Release New-CsTeamsHiddenMeetingTemplate cmdlet.
  • Adds new parameters to the Set-CsCallQueue and New-CsCallQueue Cmdlets to enable users to set No Agent Opt In/Logged In options for call handling in Call Queue. New parameters are added for No Agent disconnect/redirection options, target, shared voicemail prompts and whether to enable shared voicemail system prompt suppression and transcription.
  • May 2023 5.2.1-preview
  • [BREAKING CHANGE] Few cmdlets (like Set-CsUser) have an unintended issue in versions 5.3.0, 5.2.1-preview & 5.3.1-preview where errors like "Forest header can’t be null" is seen. Use 5.4.0 or later to mitigate this issue.
  • [BREAKING CHANGE] Adds State parameter & output attribute to [New|Get|Set|Update]-CsTeamsShiftsConnection and [New|Get|Set|Update]-CsTeamsShiftsConnectionInstance cmdlets.
  • Releases [New|Get|Set|Remove|Grant]-CsTeamsMeetingTemplatePermissionPolicy cmdlets.
  • Releases Get-CsTeamsMeetingTemplateConfiguration cmdlet.
  • Releases Get-CsTeamsFirstPartyMeetingTemplateConfiguration cmdlet.
  • Release New-CsTeamsHiddenMeetingTemplate cmdlet.
  • May 2023 5.2.0
  • Contains a new implementation of [New|Get|Set|Remove|Grant]-CsTeamsAppPermissionPolicy, [New|Get|Set|Remove|Grant]-CsTeamsAppSetupPolicy, [New|Get|Set|Remove|Grant]-CsTeamsEventsPolicy, [New|Get|Set|Remove|Grant]-CsExternalAccessPolicy, [New|Get|Set|Remove|Grant]-CsTeamsCallingPolicy. Functionality remains the same as previous implementation.
  • [BREAKING CHANGE] Updates Teams Shifts Connection cmdlets to separate connections and connection instances. The following changes apply as part of it:
    • Releases [New|Get|Set|Update]-CsTeamsShiftsConnection cmdlets.
    • Updates [New|Set|Update]-CsTeamsShiftsConnectionInstance cmdlets. Added ConnectionId & individual sync scenario parameters. Removed EnabledConnectorScenario, EnabledWfiScenario & ConnectorId parameters. Returns updated connection instance object.
    • Updates Get-CsTeamsShiftsConnectionInstance cmdlet. Returns updated connection instance object.
    • Updates Get-CsTeamsShiftsConnectionErrorReport. Added ConnectionId parameter.
    • Updates Get-CsTeamsShiftsConnectionWfmTeam. Added ConnectionId parameter.
    • Updates Get-CsTeamsShiftsConnectionConnector cmdlet. Returns updated supported connectors object.
    • Removed New-CsTeamsShiftsConnectionTeamMap cmdlet.
  • Updates [New|Set]-CsAutoAttendant, [New|Set]-CsCallQueue cmdlets. Added HideAuthorizedUsers parameter.
  • Releases [Set|Clear]-TeamsEnvironmentConfig cmdlets.
  • Releases [Get|Set]-CsTeamsSettingsCustomApp cmdlets.
  • Fixes ComplianceRecordingPolicy and ComplianceRecordingApplication cmdlets.
  • April 2023 5.1.1-preview
  • [BREAKING CHANGE] ComplianceRecordingPolicy and ComplianceRecordingApplication cmdlets are being migrated to a new implementation. Currently, MicrosoftTeams versions 5.0.1-preview, 5.1.0-GA, 5.1.1-preview aren't working for these cmdlets. Use versions <= 5.0.0 or versions >= 5.2.0-GA.
  • Adds Region parameter in the New-CsSdgBulkSignInRequest cmdlet in private preview.
  • Contains a new implementation of [New|Get|Set|Remove|Grant]-CsTeamsAppPermissionPolicy, [New|Get|Set|Remove|Grant]-CsTeamsAppSetupPolicy, [New|Get|Set|Remove|Grant]-CsTeamsEventsPolicy, [New|Get|Set|Remove|Grant]-CsExternalAccessPolicy, [New|Get|Set|Remove|Grant]-CsTeamsCallingPolicy. Functionality remains the same as previous implementation.
  • March 2023 5.1.0
  • [BREAKING CHANGE] ComplianceRecordingPolicy and ComplianceRecordingApplication cmdlets are being migrated to a new implementation. Currently, MicrosoftTeams versions 5.0.1-preview, 5.1.0-GA, 5.1.1-preview aren't working for these cmdlets. Use versions <= 5.0.0 or versions >= 5.2.0-GA.
  • [BREAKING CHANGE] Modernized versions of Get-CsOnlineUser & Get-CsOnlineVoiceUser are now being rolled out for GCC High & DoD environments as well. The following changes apply as part of it:
    • Input Parameters that aren't relevant to Teams are deprecated.
    • Output attributes:
      • Few attributes are renamed for better relevance and consistency.
      • Attributes that aren't relevant to Teams are deprecated.
      • Format types of attributes are improved.
    • Within the "-Filter" parameter for Get-CsOnlineUser, a few attributes and operators are no longer supported.
    • More details in Get-CsOnlineUser & Get-CsOnlineVoiceUser.
  • Adds TeamsEventsPolicy to Get-CsOnlineUser output.
  • Updates ProvisionedPlan attribute in Get-CsOnlineUser output. ProvisionedPlan now includes useful information such as AssignedTimestamp, ServiceInstance, Capability, ServicePlanId, SubscribedPlanId, ProvisionedTimestamp. These values are populated currently for tenants in commercial environments only.
  • Adds Force parameter to Grant-CsTeamsUpgradePolicy.
  • Contains a new implementation of [New|Get|Set|Remove]-CsTeamsVoiceApplicationsPolicy, [Get|Set]-CsTeamsMessagingConfiguration,[New|Get|Set|Remove]-CsTeamsComplianceRecordingPolicy. Functionality remains the same as previous implementation.
  • Adds RequireBackgroundEffect parameter to [New|Get|Set|Remove]-CsTeamsMeetingBrandingPolicy.
  • Adds AllowTownhalls and AllowEmailEditing parameter to [New|Get|Set|Remove]-CsTeamsEventPolicy.
  • Adds AllowWatermarkCustomizationForCameraVideo, WatermarkForCameraVideoOpacity, WatermarkForCameraVideoPattern, AllowWatermarkCustomizationForScreenSharing, WatermarkForScreenSharingOpacity, WatermarkForScreenSharingPattern parameters to [New|Get|Set|Remove]-CsTeamsMeetingPolicy.
  • Adds EnableInOrganizationChatControl parameter to [Get|Set]-CsTeamsMessagingConfiguration.
  • Adds InOrganizationChatControl parameter to [New|Get|Set|Remove]-CsTeamsMessagingPolicy.
  • Adds InboundPstnCallRoutingTreatment and InboundFederatedCallRoutingTreatment parameters to [New|Get|Set|Remove]-CsTeamsCallingPolicy.
  • Adds OrderBy (alias: Sort) parameter to Get-CsOnlineUser to enable ordering of users by property values. This parameter currently works for tenants in commercial environments only.
  • Adds new parameters to the Set-CsCallQueue and New-CsCallQueue cmdlets to enable users to set Audio file or Text to Speech Prompts when calls in Call Queue are disconnected or redirected due to overflow, timeout or when no agents are available. New parameters are added for call disconnect, redirect to user, voice app, external PSTN, and personal voicemail.
  • March 2023 5.0.1-preview
  • [BREAKING CHANGE] ComplianceRecordingPolicy and ComplianceRecordingApplication cmdlets are being migrated to a new implementation. Currently, MicrosoftTeams versions 5.0.1-preview, 5.1.0-GA, 5.1.1-preview aren't working for these cmdlets. Use versions <= 5.0.0 or versions >= 5.2.0-GA.
  • [BREAKING CHANGE] Modernized versions of Get-CsOnlineUser & Get-CsOnlineVoiceUser are now being rolled out for GCC High & DoD environments as well. The following changes apply as part of it:
    • Input Parameters that aren't relevant to Teams are deprecated.
    • Output attributes:
      • Few attributes are renamed for better relevance and consistency.
      • Attributes that aren't relevant to Teams are deprecated.
      • Format types of attributes are improved.
    • Within the "-Filter" parameter for Get-CsOnlineUser, a few attributes and operators are no longer supported.
    • More details in Get-CsOnlineUser & Get-CsOnlineVoiceUser.
  • Adds TeamsEventsPolicy to Get-CsOnlineUser output.
  • Updates ProvisionedPlan attribute in Get-CsOnlineUser output. ProvisionedPlan now includes useful information such as AssignedTimestamp, ServiceInstance, Capability, ServicePlanId, SubscribedPlanId, ProvisionedTimestamp. These values are populated currently for tenants in commercial environments only.
  • Adds Force parameter to Grant-CsTeamsUpgradePolicy.
  • Contains a new implementation of [New|Get|Set|Remove]-CsTeamsVoiceApplicationsPolicy, [Get|Set]-CsTeamsMessagingConfiguration. Functionality remains the same as previous implementation.
  • March 2023 5.0.0
  • Releases major updates for Get-CsOnlineUser with significant performance improvements and new filtering capabilities to scenarios without the "-Identity" parameter (currently rolled out in commercial environments):
    • Performance improvements especially with "-Filter" scenarios like using wildcard operator (*), OnPrem*, and Timestamp attributes.
    • New attributes are introduced in the output to ensure parity with scenarios involving the "-Identity" parameter: CountryAbbreviation, SipProxyAddress, TeamsMediaLoggingPolicy, UserValidationErrors, WhenCreated.
    • These attributes are now enabled for filtering: Alias, City, CompanyName, CompanyName, HostingProvider, UserValidationErrors, OnPremEnterpriseVoiceEnabled, OnPremHostingProvider, OnPremLineURI, OnPremSIPEnabled, SipAddress, SoftDeletionTimestamp, State, Street, TeamsOwnersPolicy, WhenChanged, WhenCreated, FeatureTypes, PreferredDataLocation, LastName.
    • These filtering operators are reintroduced into Get-CsOnlineUser:
      • "-like" operator now supports use of wildcard operators in 'contains' and 'ends with' scenarios. Example: Get-CsOnlineUser -Filter "DisplayName -like 'abc'"
      • "-contains" can now be used for filtering on properties that are an array of strings like FeatureTypes, ProxyAddresses, and ShadowProxyAddresses. Example: Get-CsOnlineUser -Filter {FeatureTypes -contains "PhoneSystem"}
      • "-gt" (greater than), "-lt" (less than), "-le" (less than or equal to) can now be used for filtering all string properties. Example: Get-CsOnlineUser -Filter {UserPrincipalName -gt/-le/-lt "abc"}
      • "-ge" (greater than or equal to) can now also be used for filtering on policies. Example: Get-CsOnlineUser -Filter {ExternalAccessPolicy -ge "xyz_policy"}
    • Updates to type of users displayed:
      • Unlicensed Users - Unlicensed users would show up in the output for 30 days post license removal.
      • Soft deleted users - These users are displayed in the output with SoftDeletionTimestamp set to a value.
    February 2023 4.9.4-preview
  • Releases Get-CsSDGBulkSignInRequestsSummary cmdlet in private preview.
  • Adds Region attribute to Get-CsSdgBulkSignInRequestStatus output.
  • January 2023 4.9.3
  • Adds Certificate parameter to Connect-MicrosoftTeams.
  • Adds WelcomeTextToSpeechPrompt parameter to [New|Set]-CsCallQueue.
  • Fixes issues with pipeline input for Test-CsEffectiveTenantDialPlan & Test-CsVoiceNormalizationRule cmdlets.
  • Releases [Get|Set|Grant|Remove|New]-CsTeamsMeetingBrandingPolicy cmdlets.
  • In CsTeamsMeetingBrandingPolicy cmdlets, there's a known issue that prevents using the 'Remove' list modifier when trying to delete a TeamsMeetingBrandingTheme or a NdiAssuranceSlate. To remove all elements from MeetingBrandingThemes, the workaround is setting the values to null, example: Set-CsTeamsMeetingBrandingPolicy -Identity <Identity> -MeetingBrandingThemes $null -DefaultTheme "".
    • To update the MeetingBrandingThemes, use the [Set]-CsTeamsMeetingBrandingPolicy cmdlet and pass the list of desired MeetingBrandingThemes created with the [New]-CsTeamsMeetingBrandingTheme cmdlet. Example: $exampleMeetingBrandingTheme = New-CsTeamsMeetingBrandingTheme -DisplayName "exampleTheme" -LogoImageLightUri "https://contoso.com/light.jpg" -LogoImageDarkUri "https://contoso.com/dark.jpg" -BackgroundImageLightUri "https://contoso.com/backgroundlight.jpg" -BackgroundImageDarkUri "https://contoso.com/backgrounddark.jpg" -BrandAccentColor "#000000" -Enabled $true -Identity "exampleTheme"
    • And then set the themes using the Set cmdlet: Set-CsTeamsMeetingBrandingPolicy -Identity <Identity> -MeetingBrandingThemes @($exampleMeetingBrandingTheme) -DefaultTheme "exampleTheme"
    • Use the same approach for removing elements from NdiAssuranceSlate, using the [New]-CsTeamsNdiAssuranceSlate cmdlet and then using Set-CsTeamsMeetingBrandingPolicy to properly set the values.
    • This issue will be fixed in the next version.
  • Releases [New]-CsTeamsMeetingBackgroundImage cmdlet.
  • Releases [New]-CsTeamsMeetingBrandingTheme cmdlet.
  • Releases [New]-CsTeamsNdiAssuranceSlate cmdlet.
  • Contains a new implementation of [New|Get|Set|Remove]-CsTeamsCallHoldPolicy, [New|Get|Set|Remove]-CsTeamsEmergencyCallingPolicy, [New]-CsTeamsEmergencyCallingExtendedNotification. Functionality remains the same as previous implementation.
  • January 2023 4.9.2-preview
  • Releases Get-CsSdgBulkSignInRequestStatus & New-CsSdgBulkSignInRequest cmdlets in private preview.
  • Adds Certificate parameter to Connect-MicrosoftTeams.
  • Adds WelcomeTextToSpeechPrompt parameter to [New|Set]-CsCallQueue.
  • Fixes issues with pipeline input for Test-CsEffectiveTenantDialPlan & Test-CsVoiceNormalizationRule cmdlets.
  • November 2022 4.9.1
  • Releases Application-based authentication support in Connect-MicrosoftTeams in GA. More details in Application-based authentication in Teams PowerShell Module.
  • Contains a new implementation of [New|Get|Set|Remove]-CsTeamsChannelsPolicy and [New|Get|Set|Remove]-CsTeamsUpdateManagementPolicy. Functionality remains the same as previous implementation.
  • Adds UseNewTeamsClient parameter to TeamsUpdateManagementPolicy.
  • Adds EnablePrivateTeamDiscovery parameter to TeamsChannelsPolicy.
  • Fixes issues with authentication token not refreshing for some policy cmdlets.
  • Fixes issues where display format was broken for some cmdlets.
  • Adds SipProxyAddress, TeamsMediaLoggingPolicy, CountryAbbreviation, UserValidationErrors, and WhenCreated attributes in Get-CsOnlineUser output when run without -Identity parameter. Out of these attributes, CountryAbbreviation, UserValidationErrors, and WhenCreated don't show any values yet. These updates are gradually rolled out, more details in Get-CsOnlineUser.
  • Fixes Add-TeamChannelUser & Remove-TeamChannelUser to take UPN for -User parameter to manage external members in a shared channel.
  • October 2022 4.9.0
  • Releases [Get|Set]-CsTeamsEducationConfiguration cmdlets in GA.
  • Contains a new implementation of [New|Get|Set|Remove]-CsTeamsFeedbackPolicy, [New|Get|Set|Remove]-CsTeamsMessagingPolicy, [New|Get|Set|Remove]-CsTeamsMeetingPolicy, and [New|Get|Set|Remove]-CsOnlineVoicemailPolicy. Functionality remains the same as previous implementation.
  • Adds ExplicitRecordingConsent, ForceStreamingAttendeeMode parameters to TeamsMeetingPolicy.
  • Adds Description, PreambleAudioFile, PostambleAudioFile, PreamblePostambleMandatory parameters to OnlineVoicemailPolicy.
  • Adds AllowChatWithGroup parameter to TeamsMessagingPolicy.
  • Adds EnableFeatureSuggestions parameter to TeamsFeedbackPolicy.
  • Releases Update-CsTeamsShiftsConnectionInstance cmdlet.
  • October 2022 4.8.1-preview
  • Contains a new implementation of [New|Get|Set|Remove]-CsTeamsMessagingPolicy, [New|Get|Set|Remove]-CsTeamsMeetingPolicy, and [New|Get|Set|Remove]-CsOnlineVoicemailPolicy. NOTE: These Cmdlets currently only work with powershell.exe. They don't work for pwsh.exe. This issue will be fixed in the next GA release.
  • Adds ExplicitRecordingConsent, ForceStreamingAttendeeMode parameters to TeamsMeetingPolicy.
  • Adds Description, PreambleAudioFile, PostambleAudioFile, PreamblePostambleMandatory parameters to OnlineVoicemailPolicy.
  • Adds AllowChatWithGroup and EnableFeatureSuggestions parameters to TeamsMessagingPolicy.
  • Releases Update-CsTeamsShiftsConnectionInstance cmdlet.
  • October 2022 4.8.0
  • [Get|New]-CsTeamsShiftsConnectionTeamMap cmdlets - TimeZone attribute added.
  • Removes SendEmailFromAddress and SendEmailFromDisplayName input parameters from Set-CsOnlineDialinConferencingUser.
  • Removes AllowAllAcsResources and BlockedAcsResources parameters from Set-TeamsAcsFederationConfiguration.
  • Adds ForceListenMenuEnabled parameter to call flow settings in New-CsAutoAttendantCallFlow, New-CsAutoAttendant, and Set-CsAutoAutoAttendant. This setting enables the tenant to ignore DTMF/speech inputs while greetings/menu options are played.
  • September 2022 4.7.1-preview
  • Releases Application-based authentication support in Connect-MicrosoftTeams in preview. The supported cmdlets are being gradually rolled out, more details in Application-based authentication in Teams PowerShell Module.
  • Releases [Get|Set]-CsTeamsEducationConfiguration cmdlets in private preview.
  • [Get|New]-CsTeamsShiftsConnectionTeamMap cmdlets - TimeZone attribute added.
  • Removes SendEmailFromAddress and SendEmailFromDisplayName input parameters from Set-CsOnlineDialinConferencingUser.
  • Removes AllowAllAcsResources and BlockedAcsResources parameters from Set-TeamsAcsFederationConfiguration.
  • September 2022 4.7.0
  • Fixes issues with process clean-up when using module on PS ISE and dotnet applications.
  • Releases [Get|New]-CsBatchTeamsDeployment cmdlets in GA.
  • Releases [New|Set]-CSTeamsShiftsConnectionInstance, Test-CsTeamsShiftsConnectionValidate support for UKG Dimensions.
  • Fixes issues with incorrect token fetch while choosing between multiple accounts using AccountId parameter in Connect-MicrosoftTeams.
  • Default values of Conference mode & Presence mode attributes are changed from false to true for New-CsCallQueue cmdlet.
  • August 2022 4.6.1-preview
  • Fixes issues with process clean-up when using module on PS ISE and dotnet applications.
  • July 2022 4.6.0
  • Releases AccountType parameter for the Get-CsOnlineUser cmdlet, which allows querying for specific type of users.
  • AccountType attribute is added in the Get-CsOnlineUser output indicating the user type. Possible values for AccountType are: 'User' (user accounts), 'ResourceAccount' (app endpoints or resource accounts), 'Guest' (guest accounts) & 'Unknown' (user type not known).
  • Fixes issues with Rank & Group parameters in Grant-Cs<PolicyName> cmdlets.
  • Releases [Get|Set|New|Remove|Grant]-CsTeamsEventsPolicy Cmdlets.
  • Removes all the deprecated & nonsupported cmdlets. Details in Teams PowerShell supported versions.
  • Releases modernized versions of [New|Get]-CsCloudCallDataConnection cmdlets.
  • Releases [Get|Remove]-SharedWithTeam cmdlets.
  • Releases Get-TeamAllChannel cmdlet.
  • Releases Get-TeamIncomingChannel cmdlet.
  • Releases Get-AssociatedTeam cmdlet.
  • Releases Get-SharedWithTeamUser cmdlet.
  • Supports TenantId optional parameter for the Add-TeamChannelUser cmdlet.
  • Releases Get-TeamTargetingHierarchyStatus & [Remove|Set]-TeamTargetingHierarchy cmdlets.
  • July 2022 4.5.1-preview
  • Releases AccountType parameter for the Get-CsOnlineUser cmdlet, which allows querying for specific type of users.
  • AccountType attribute is added in the Get-CsOnlineUser output indicating the user type. Possible values for AccountType are: 'User' (user accounts), 'ResourceAccount' (app endpoints or resource accounts), 'Guest' (guest accounts) & 'Unknown' (user type not known).
  • Fixes issues with Rank & Group parameters in Grant-Cs<PolicyName> cmdlets.
  • June 2022 4.5.0
  • Supports IncludeResources parameter for the Get-CsAutoAttendantStatus cmdlet.
  • Supports SoftDeletedUsers parameter for the Get-CsOnlineUser cmdlet.
  • Releases [Get|Grant]-CsTeamsMediaLoggingPolicy cmdlets.
  • Supports AuthorizedUsers optional parameter for the [New|Set]-CsAutoAttendant & [New|Set]-CsCallQueue cmdlets.
  • Fixes shared voicemail prompt parameters where prompt type couldn't be switched after they're set for Set-CsCallQueue cmdlet.
  • Fixes [New|Set]-CsOnlineSchedule cmdlets to work in the European date-time format.
  • Releases [New|Get|Set|Remove|Grant]-CsTeamsVoiceApplicationsPolicy cmdlets.
  • Releases Get-CsHybridTelephoneNumber cmdlet.
  • Releases modernized versions of [New|Remove]-CsHybridTelephoneNumber cmdlets.
  • Supports ToneStar and TonePound as value for DtmfResponse parameter in the New-CsAutoAttendantMenuOption cmdlet.
  • Fixes issues with PSListModifier in the AllowedDomainsAsAList parameter in the modernized Set-CsTenantFederationConfiguration cmdlet.
  • Supports Group and Rank parameters for all Grant-Cs<PolicyName> cmdlets.
  • Releases Test-CsTeamsTranslationRule cmdlet.
  • June 2022 4.4.3-preview
  • Supports IncludeResources parameter for the Get-CsAutoAttendantStatus cmdlet.
  • Supports SoftDeletedUsers parameter for the Get-CsOnlineUser cmdlet.
  • Releases [Get|Grant]-CsTeamsMediaLoggingPolicy cmdlets.
  • Supports AuthorizedUsers optional parameter for the [New|Set]-CsAutoAttendant & [New|Set]-CsCallQueue cmdlets.
  • Fixes shared voicemail prompt parameters where prompt type couldn't be switched after they're set for Set-CsCallQueue cmdlet.
  • Fixes [New|Set]-CsOnlineSchedule cmdlets to work in the European date-time format.
  • May 2022 4.4.1
  • Improvements in the size of the module.
  • Parameters not supported in the modernized version of all the cmdlets result in error.
  • Fixes error handling for [Get|Set]-CsOnlineDialInConferencingUser, Get-CsOnlineDialInConferencingBridge, [Get|Set|Register|Unregister]-CsOnlineDialInConferencingServiceNumber & Get-CsOnlineDialInConferencingLanguagesSupported cmdlets.
  • Deprecates Test-CsOnlineLisCivicAddress cmdlet.
  • User Principal Name (UPN) & GUID can be used now as identity in modernized [Get|Remove]-CsOnlineApplicationInstanceAssociation cmdlets.
  • [BREAKING CHANGE] Get-CsOnlineUser - Policy attributes in the output are now null if a user doesn’t have that policy assigned. These attributes used to be empty UserPolicyDefinition objects in earlier versions (3.0.0 to 4.3.1).
  • Fixes Set-CsCallQueue to allow null or empty array values in the input parameters.
  • Get-CsPhoneNumberAssignment - City & IsoSubdivision attributes are added to the output.
  • May 2022 4.3.1-preview
  • Improvements in the size of the module.
  • Parameters not supported in the modernized version of all the cmdlets result in error.
  • Fixes error handling for [Get|Set]-CsOnlineDialInConferencingUser, Get-CsOnlineDialInConferencingBridge, [Get|Set|Register|Unregister]-CsOnlineDialInConferencingServiceNumber & Get-CsOnlineDialInConferencingLanguagesSupported cmdlets.
  • Releases Deployment at Scale cmdlets in preview - New-CsBatchTeamsDeployment & Get-CsBatchTeamsDeploymentStatus.
  • User Principal Name (UPN) & GUID can be used now as identity in modernized [Get|Remove]-CsOnlineApplicationInstanceAssociation cmdlets.
  • May 2022 4.3.0
  • Fixes error handlings for [Set|Remove]-CsPhoneNumberAssignment cmdlets.
  • [Get|Set|Remove]-CsOnlineLisSubnet – fixes for Subnet parameter in the modernized cmdlets.
  • [Get|Set]-CsOnlineLisLocation & [Get|Set]-CsOnlineLisCivicAddress – fixes around the supported parameters in the modernized cmdlets (more details in the respective public documentations).
  • April 2022 4.2.1-preview
  • Fixes error handlings for [Set|Remove]-CsPhoneNumberAssignment cmdlets.
  • [Get|Set|Remove]-CsOnlineLisSubnet – fixes for Subnet parameter in the modernized cmdlets.
  • [Get|Set]-CsOnlineLisLocation & [Get|Set]-CsOnlineLisCivicAddress – fixes around the supported parameters in the modernized cmdlets.
  • April 2022 4.2.0
  • Proxy support for all the cmdlets relevant for Teams. The supported cmdlets are being gradually rolled out.
  • Fixes issues with [New|Set]- modernized Policy cmdlets when used with PSListModifier type parameters.
  • [BREAKING CHANGE] PSListModifier type parameters now only accept Hashtable with Add or Remove. Hashtable with Replace isn't supported now, instead value(s) can be set directly in the parameter.
  • Fixes format issues with [Get|New]- of few modernized Policy cmdlets (CsVideoInteropServiceProvider, CsInboundBlockedNumberPattern, CsTeamsComplianceRecordingApplication, CsTeamsTranslationRule, CsTeamsUnassignedNumberTreatment, CsVoiceNormalizationRule).
  • Improved performance of pipeline input processing with the modernized cmdlets.
  • Fixes minor issues with pipeline input results.
  • Get-CsOnlineUser: Country attribute (known as CountryOrRegionDisplayName in versions earlier than 3.x.x), is added.
  • [BREAKING CHANGE] Get-CsOnlineUser: CountryAbbreviation attribute is now only available when used with -Identity parameter.
  • March 2022 4.1.0
  • Fixes issues with warning and error variables.
  • Fixes issues with using modernized cmdlets with PowerShell Runspaces.
  • Releases [Get|New|Set|Remove]-CsTeamsShiftsConnectionInstance Cmdlets.
  • Releases [Get|New|Remove]-CsTeamsShiftsConnectionTeamMap Cmdlets.
  • Releases Get-CsTeamsShiftsConnectionWfm[User|Team] Cmdlets.
  • Releases Get-CsTeamsShiftsConnectionConnector, Get-CsTeamsShiftsConnectionSyncResult, New-CsTeamsShiftsConnectionBatchTeamMap, Remove-CsTeamsShiftsScheduleRecord, Test-CsTeamsShiftsConnectionValidate, Get-CsTeamsShiftsConnectionOperation & Get-CsTeamsShiftsConnectionErrorReport Cmdlets.
  • March 2022 4.0.1-preview
  • Fixes issues with ErrorAction common parameter.
  • March 2022 4.0.0
  • This GA release completes the modernization of all the cmdlets relevant for Teams only organizations. The modern versions are gradually rolled out, so some organizations continue to see the older remoting versions.
  • Releases [New|Set|Remove]-CsUserCallingDelegate and [Get|Set]-CsUserCallingSettings cmdlets in GA.
  • [BREAKING CHANGE] Except New-CsVoiceNormalizationRule; the InMemory switch is no longer supported for other cmdlets.
  • Deprecates the following cmdlets: ConvertTo-JsonForPSWS, Set-CsUserServicesPolicy, [Get|Set]-CsNetworkConfiguration, [Set|Remove]-CsTenantNetworkConfiguration, New-CsNetworkMediaBypassConfiguration, [Get|Grant|New|Remove|Set]-CsTeamsVerticalPackagePolicy,[Get|Remove|Set]-CsVoiceNormalizationRule.
  • [BREAKING CHANGE] Get-CsOnlineVoicemailPolicy returns data for MaximumRecordingLength in string format instead of TimeSpan.
  • February 2022 3.2.0-preview
  • This release completes the modernization of all the cmdlets relevant for Teams only organizations. The modern versions are gradually rolled out, so some organizations continue to see the older remoting versions.
  • [BREAKING CHANGE] Except New-CsVoiceNormalizationRule; the InMemory switch is no longer supported for other cmdlets.
  • Connect-MicrosoftTeams performance improvements.
  • Fixes for Import-Module with Prefix.
  • Fixes handling ports with slash character "/" in [Get|Set|Remove]-CsOnlineLisPort.
  • Releases Test-CsTeamsUnassignedNumberTreatment cmdlet.
  • Deprecates the following cmdlets: ConvertTo-JsonForPSWS, Set-CsUserServicesPolicy, [Get|Set]-CsNetworkConfiguration, [Set|Remove]-CsTenantNetworkConfiguration, New-CsNetworkMediaBypassConfiguration, [Get|Grant|New|Remove|Set]-CsTeamsVerticalPackagePolicy, [Get|Remove|Set]-CsVoiceNormalizationRule.
  • February 2022 3.1.1
  • Performance improvements for Import-Module.
  • PSListModifier deserialization issue is fixed.
  • January 2022 3.1.0
  • Renamed Cmdlet from Get-CsTeamsShiftsConnectionUser to Get-CsTeamsShiftsConnectionWfmUser.
  • Releases new parameters ResultSize, SkipUserPolicies for Get-CsOnlineUser.
  • Releases new parameters ResultSize for Get-CsOnlineDialInConferencingUser.
  • Releases new parameters First, NumberAssigned, NumberNotAssigned, PSTNConnectivity, EnterpriseVoiceStatus, CivicAddressId, LocationId for Get-CsOnlineVoiceUser.
  • December 2021 3.0.1-preview
  • Releases modernized versions of Grant-CsTeamsFilesPolicy and Remove-CsTeamsFilesPolicy. These cmdlets are expected to work similar to their remoting counterparts. The modern versions are gradually rolled out. So some tenants see the older remoting version (until the rollout completes).
  • Releases [New|Set|Remove]-CsUserCallingDelegate cmdlets in preview.
  • Releases [Get|Remove]-CsTeamsShiftsConnectionErrorReport cmdlets in preview.
  • Releases Get-CsTeamsShiftsConnectionOperation cmdlet in preview.
  • Releases New-CsTeamsShiftsConnectionBatchTeamMap cmdlet in preview.
  • Releases Remove-CsTeamsShiftsScheduleRecord cmdlet in preview.
  • November 2021 3.0.0
  • [BREAKING CHANGE] Get-CsOnlineUser and Get-CsOnlineVoiceUser: The following changes apply for TeamsOnly tenants:
    • These cmdlets are migrated from the earlier implementation to the newer APIs.
    • (Using -Identity parameter): Attributes that are no longer relevant for Teams are deprecated for TeamsOnly Tenants. Some attributes are also renamed/replaced—see Get-CsOnlineUser and Get-CsOnlineVoiceUser.
    • Get-CsOnlineUser (with -Filter parameter): Formatting for filtering based on AssignedPlans and EnterpriseVoice is modified. Filterable attributes are temporarily limited (based on usage) for TeamsOnly Users—see Get-CsOnlineVoiceUser.
    • These cmdlets are gradually rolled out and some tenants won't 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 are deprecated for TeamsOnly tenants—see Get-CsTenant.
  • Releases modernized versions of all 75+ Grant-Cs<Name>Policy cmdlets (all parameter sets). These cmdlets are expected to work similar to their remoting counterparts. The modern versions are 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 cmdlets are expected to work similar to their remoting counterparts. The modern versions are gradually rolled out, so some tenants will see the earlier remoting version (until the rollout completes).
  • Releases [Set|Remove]-CsPhoneNumberAssignment cmdlets. These cmdlets are 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 cmdlets are expected to work similar to their remoting counterparts. The modern versions are 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 cmdlets are expected to work similar to their remoting counterparts. The modern versions are gradually rolled out, tenants that aren't flighted will see the older remoting version.
  • Releases Set-CsUserCallingSettings cmdlet in preview.
  • 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 are 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 in preview.
  • 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 it's 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 Cloud Shell is fixed. It now defaults to using the logged-in identity of the user instead of prompting for reauthentication.
  • TeamsUnassignedNumberTreatment cmdlets are now available.
  • Get-CsOnlineDialInConferencingBridge and Set-CsOnlineDialInConferencingBridge cmdlets are migrated from the older implementation to the newer APIs.
  • Modernized versions of Get-CsTenant and Get-CsOnlineUser (with -identity parameter only) are released. They no longer emit deprecated properties and have some formatting changes compared to their remoting counterparts.
  • Note: The New-Team related updates are reverted from 2.5.0 and the previous version is 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 issue is 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's replaced with Connect-MicrosoftTeams.
  • Enable-csonlinesessionforreconnection is no longer required. This feature is 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 is prompted twice during initial authentication when they don't 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