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
Default (Default)
New-CsTeamsUpgradePolicy
[-Identity] <XdsIdentity>
[-NotifySfbUsers <Boolean>]
[-Description <String>]
[<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 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 $true
This 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 $true
This creates a policy for users that can be granted as desired to individual users
Parameters
-Description
Applicable: Skype for Business Server 2019
Free form text that can be used as needed by administrators.
Parameter properties
| Type: | String |
| 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 |
-Identity
Applicable: Skype for Business Server 2019
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.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-NotifySfbUsers
Applicable: Skype for Business Server 2019
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.
Parameter properties
| Type: | Boolean |
| 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.