Edit

Share via

Get-CsTeamsUpgradeConfiguration

Module:
MicrosoftTeams PowerShell module

Returns information related to managing the upgrade to Teams from Skype for Business.

Syntax

Identity (Default) 

Get-CsTeamsUpgradeConfiguration
    [[-Identity] <XdsIdentity>]
    [-Tenant <Guid>]
    [-LocalStore]
    [<CommonParameters>]

Filter 

Get-CsTeamsUpgradeConfiguration
    [-Tenant <Guid>]
    [-Filter <String>]
    [-LocalStore]
    [<CommonParameters>]

Description

TeamsUpgradeConfiguration is used in conjunction with TeamsUpgradePolicy. The settings in TeamsUpgradeConfiguration allow administrators to configure whether users subject to upgrade and who are running on Windows clients should automatically download the Teams app. It also allows administrators to determine which application Office 365 users should use to join Skype for Business meetings.

Separate instances of TeamsUpgradeConfiguration exist in Office 365 and Skype for Business Server.

  • TeamsUpgradeConfiguration in Office 365 applies to any user who does not have an on-premises Skype for Business account.
  • TeamsUpgradeConfiguration in Skype for Business Server can used to manage on-premises users in a hybrid environment. In on-premises, only the DownloadTeams property is available.

The DownloadTeams property allows admins to control whether the Skype for Business client should automatically download the Teams app in the background. This setting is only honored for users on Windows clients, and only if TeamsUpgradePolicy for the user meets either of these conditions:

  • NotifySfbUser=true, or
  • Mode=TeamsOnly Otherwise, this setting is ignored.

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 NativeLimitedClient. "NativeLimitedClient" means the existing Skype for Business rich client will be used, but since the user is upgraded, only meeting functionality is available. Calling and Messaging are done via Teams. "SkypeMeetingsApp" means use the web-downloadable app. This setting can be useful for organizations that have upgraded to Teams and no longer want to install Skype for Business on their users' computers. This property is only available when configuring TeamsUpgradeConfiguration in Office 365. It is not honored for users homed on-premises in Skype for Business Server.

Examples

Example 1

PS C:\> Get-CsTeamsUpgradeConfiguration

The above cmdlet lists the properties of TeamsUpgradeConfiguration.

Parameters

-Identity

{{Fill Identity Description}}

Parameter properties

Type:XdsIdentity
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LocalStore

Do not use

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Tenant

{{Fill Tenant Description}}

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object

Notes

These settings are only honored by newer versions of Skype for Business clients.