Set-CsTeamsUpgradePolicy

In on-premises deployments of Skype for Business Server, TeamsUpgradePolicy enables administrators to control whether users see a notification in their Skype for Business client of a pending upgrade to Teams. In addition, when this policy is assigned to a user, administrators can optionally have Win32 versions of Skype for Business clients silently download the Teams app based on the value of TeamsUpgradeConfiguration.

Syntax

Set-CsTeamsUpgradePolicy
   [-Tenant <Guid>]
   [-Description <String>]
   [-NotifySfbUsers <Boolean>]
   [[-Identity] <XdsIdentity>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CsTeamsUpgradePolicy
   [-Tenant <Guid>]
   [-Description <String>]
   [-NotifySfbUsers <Boolean>]
   [-Instance <PSObject>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

In on-premises deployments of Skype for Business Server, TeamsUpgradePolicy enables administrators to control whether users see a notification of a pending upgrade to Teams in their Skype for Business client. The Set-CsTeamsUpgradePolicy lets the administrator modify an existing instance of TeamsUpgradePolicy for users homed in Skype for Business on-premises. Notifications are enabled by the boolean parameter NotifySfBUsers.

For users with Win32 versions of Skype for Business, if DownloadTeams=true in TeamsUpgradeConfiguration, users who are assigned an instance of TeamsUpgradePolicy with NotifySfBUsers=true will have Teams automatically downloaded in the background.

Notes:

  • Instances of TeamsUpgradePolicy created in on-premises will not apply to any users that are already homed online.
  • Office 365 already provides built-in instances of TeamsUpgradePolicy, so there is no New-CsTeamsUpgradePolicy cmdlet for the online environment by design.

Examples

Example 1

PS C:\> Set-CsTeamsUpgradePolicy -Identity Site:Redmond1 -NotifySfbUsers $false

This disables notifications for users in the Redmond1 site.

Parameters

-Description

Free form text that can be used by administrators as desired.

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

The identity of the policy. To specify the global policy for the organization, use "global". To specify a specific site, use "site:<name>" where <name> is the name of the site. To specify any other policy provide the name of that policy.

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

If true, users with this policy see a notification in their Skype for Business client indicating that Teams is coming soon.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 Server 2019

Inputs

System.Management.Automation.PSObject

Outputs

System.Object