Commands › Microsoft Teams
Set-CsTeamsUpgradeConfiguration
Manage certain aspects of client behavior for users being upgraded from Skype for Business to Teams.
Quick start script
# Set-CsTeamsUpgradeConfiguration — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsUpgradeConfiguration
$before | Format-List
# 3. Make the change (dry run first)
Set-CsTeamsUpgradeConfiguration -WhatIf
Set-CsTeamsUpgradeConfiguration
# 4. Verify and diff
$after = Get-CsTeamsUpgradeConfiguration
Compare-Object ($before | Out-String) ($after | Out-String)Syntax — 2 parameter sets
Identity (Default)
Set-CsTeamsUpgradeConfiguration [-Tenant <Guid>] [-DownloadTeams <Boolean>] [-SfBMeetingJoinUx <String>] [-BlockLegacyAuthorization <Boolean>]
[[-Identity] <XdsIdentity>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Instance
Set-CsTeamsUpgradeConfiguration [-Tenant <Guid>] [-DownloadTeams <Boolean>] [-SfBMeetingJoinUx <String>] [-BlockLegacyAuthorization <Boolean>]
[-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (8)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -BlockLegacyAuthorization | Boolean | This setting will force Teams clients to enforce session revocation for core Messaging and Calling/Meeting scenarios. If turned ON, session revocation will be enforced for calls, chats and meetings for opted-in... | |
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -DownloadTeams | Boolean | The DownloadTeams property allows admins to control whether the Skype for Business client should automatically download Teams in the background. This Boolean setting is only honored on Windows clients, and only for... | |
| -Force | SwitchParameter | Suppresses the display of any non-fatal error message that might arise when running the command. | |
| -Identity | XdsIdentity | For internal use only. | |
| -SfBMeetingJoinUx | string | The SfBMeetingJoinUx property allows admins to specify which app is used to join Skype for Business meetings, even after the user has been upgraded to Teams. Allowed values are: "SkypeMeetingsApp" and... | |
| -Tenant | Guid | For internal use only. | |
| -WhatIf | SwitchParameter | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.