Get-CsTeamsUpgradePolicy

TeamsUpgradePolicy allows administrators to manage the transition from Skype for Business to Teams. IMPORTANT: TeamsUpgradePolicy has replaced TeamsInteropPolicy. However, aspects of TeamsUpgradePolicy are still in preview mode as described below.

Syntax

Get-CsTeamsUpgradePolicy
   [-Tenant <Guid>]
   [[-Identity] <XdsIdentity>]
   [-LocalStore]
   [<CommonParameters>]
Get-CsTeamsUpgradePolicy
   [-Tenant <Guid>]
   [-Filter <String>]
   [-LocalStore]
   [<CommonParameters>]

Description

TeamsUpgradePolicy allows administrators to manage the transition from Skype for Business to Teams. This cmdlet returns the set of instances of this policy. As an organization with Skype for Business starts to adopt Teams, administrators can manage client behavior for their end user using the concept of "mode", which defines where routing behavior (e.g in which client do chats and calls land). In the future, mode will also be used to define client behavior in Teams client in terms of what functionality will be available. TeamsUpgradePolicy can be granted either on a per user basis or on a tenant-wide basis. In addition, prior to upgrading to TeamsOnly mode, administrators can use TeamsUpgradePolicy to trigger notifications in the Skype for Business client to inform users of the pending upgrade.

NOTES:

  • Except for on-premise versions of Skype for Business Server, all relevant instances of TeamsUpgradePolicy are built into the system, so there is no corresponding New cmdlet.
  • If you are using Skype for Business Server, there are no built-in instances and you'll need to create one. Also, only the NotifySfBUsers property is available. Mode is not present
  • Instances with mode set to SfBWithTeamsCollab are not yet functional. From a routing perspective, this will behave like SfBOnly mode.
  • Action property is redundnant with the combination of NotifySfBUsers and Mode. It will eventually be removed.

IMPORTANT: TeamsUpgradePolicy has replaced TeamsInteropPolicy. Components that previously honored TeamsInteropPolicy have been updated to honor TeamsUpgradePolicy instead.

Examples

Example 1: List all instances of TeamsUpgradePolicy (Skype for Business Online)

PS C:\> Get-CsTeamsUpgradePolicy

Identity       : Global
Description    : Users can use either Skype for Business client or Teams client
Mode           : Legacy
NotifySfbUsers : False
Action         : None

Identity       : Tag:NoUpgrade
Description    : Users can use either Skype for Business client or Teams client
Mode           : Legacy
NotifySfbUsers : False
Action         : None

Identity       : Tag:NotifyForTeams
Description    : Show notification of pending upgrade in Skype for Business client
Mode           : Legacy
NotifySfbUsers : True
Action         : Notify

Identity       : Tag:UpgradeToTeams
Description    : Use Teams Only
Mode           : TeamsOnly
NotifySfbUsers : False
Action         : Upgrade

Identity       : Tag:Islands
Description    : Use either Skype for Business client or Teams client
Mode           : Islands
NotifySfbUsers : False
Action         : None

Identity       : Tag:IslandsWithNotify
Description    : Use either Skype for Business client or Teams client
Mode           : Islands
NotifySfbUsers : True
Action         : Notify

Identity       : Tag:SfBOnly
Description    : Use only Skype for Business
Mode           : SfBOnly
NotifySfbUsers : False
Action         : None

Identity       : Tag:SfBOnlyWithNotify
Description    : Use only Skype for Business
Mode           : SfBOnly
NotifySfbUsers : True
Action         : Notify

Identity       : Tag:SfBWithTeamsCollab
Description    : Use Skype for Business and use Teams only for group collaboration
Mode           : SfBWithTeamsCollab
NotifySfbUsers : False
Action         : None

Identity       : Tag:SfBWithTeamsCollabWithNotify
Description    : Use Skype for Business and use Teams only for group collaboration
Mode           : SfBWithTeamsCollab
NotifySfbUsers : True
Action         : Notify

List all instances of TeamsUpgradePolicy

Example 2: List the global instance of TeamsUpgradePolicy (which applies to all users in a tenant unless they are explicitly assigned an instance of this policy)

PS C:\> Get-CsTeamsUpgradePolicy -Identity Global

Identity       : Global
Description    : Users can use either Skype for Business client or Teams client
Mode           : Legacy
NotifySfbUsers : False
Action         : None

List the global instance of TeamsUpgradePolicy

Example 3: List all instances of TeamsUpgradePolicy in an on-premises environment

PS C:\> Get-CsTeamsUpgradePolicy -Identity Global

Identity       : Global
Description    : Notifications are disabled
NotifySfbUsers : False

List all on-premises instances (if any) of TeamsUpgradePolicy.

Optional Parameters

-Filter

{{Fill Filter Description}}

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online, Skype for Business Server 2019
-Identity

If identity parameter is passed, this will return a specific instance. If no identity parameter is specified, the cmdlet returns all instances.

Type:XdsIdentity
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online, Skype for Business Server 2019
-LocalStore

Do Not Use

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online, Skype for Business Server 2019
-Tenant

{{Fill Tenant Description}}

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online, Skype for Business Server 2019

Inputs

None

Outputs

System.Object