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
NOTE: This cmdlet is only relevant for Skype for Business Server 2019. It does not apply for Skype for Business Online.
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 Set-CsTeamsUpgradePolicy cmdlet for the online environment by design.
Examples
Example 1
Set-CsTeamsUpgradePolicy -Identity Site:Redmond1 -NotifySfbUsers $falseThis 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2019 |
Inputs
System.Management.Automation.PSObject
Outputs
System.Object