New-CsTeamsUpgradePolicy
In on-premises deployments of Skype for Business Server, TeamsUpgradePolicy enables administrators to control whether user 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 Teams based on the value of CsTeamsUpgradeConfiguration.
Syntax
New-CsTeamsUpgradePolicy
[-Identity] <XdsIdentity>
[-NotifySfbUsers <Boolean>]
[-Description <String>] 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 new-CsTeamsUpgradePolicy lets the administrator create a policy that can be assigned to users homed in Skype for Business on-premises to notify of them of a pending upgrade to Teams. Notifications are enabled by the boolean parameter NotifySfBUsers.
For users with Win32 versions of Skype for Business, if DownloadTeams=true in CsTeamsUpgradeConfiguration, 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.
- Skype for Business Online already provides built-in instances of TeamsUpgradePolicy, so there is no New-CsTeamsUpgradePolicy cmdlet for the online environment by design.
Examples
Example 1: Create a site-level policy
PS C:\> new-CsTeamsUpgradePolicy -identity site:Redmond1 -NotifySfBUsers $trueThis creates a policy for users in the site Redmond1.
Example 2: Create a policy not specific to a site.
PS C:\> new-CsTeamsUpgradePolicy -identity EnableNotifications -NotifySfBUsers $trueThis creates a policy for users that can be granted as desired to individual users
Parameters
-Description
Free form text that can be used as needed by administrators.
| 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 a policy that can be assigned as needed to any users, simply specify a name of your choosing.
| Type: | XdsIdentity |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2019 |
-NotifySfbUsers
Determines whether users who are assigned this policy will see a notification in their Skype for Business client about a pending upgrade to Teams. In addition, if NotifySfBUsers=true and TeamsUpgradeConfiguration has DownloadTeams=true, Win32 versions of Skype for Business will silently download the Teams client.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2019 |
Inputs
None
Outputs
System.Object