Skip to content

Commit 0ac9074

Browse files
authored
Merge pull request MicrosoftDocs#2148 from MicrosoftDocs/kenwith-patch-4
Restore changes.
2 parents 1f08870 + 82b148d commit 0ac9074

File tree

1 file changed

+51
-101
lines changed

1 file changed

+51
-101
lines changed

skype/skype-ps/skype/Grant-CsTeamsUpgradePolicy.md

Lines changed: 51 additions & 101 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,64 @@
11
---
2-
external help file:
3-
applicable: Skype for Business Online
2+
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
3+
applicable: Skype for Business Online, Skype for Business Server 2019
44
title: Grant-CsTeamsUpgradePolicy
55
schema: 2.0.0
66
---
77

88
# Grant-CsTeamsUpgradePolicy
99

1010
## SYNOPSIS
11-
TeamsUpgradePolicy allows administrators to manage the transition from Skype for Business to Teams. IMPORTANT: TeamsUpgradePolicy will replace TeamsInteropPolicy. Aspects of TeamsUpgradePolicy are still in preview mode as described below.
11+
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.
1212

1313

1414
## SYNTAX
1515

16-
### Identity (Default)
1716
```
18-
Grant-CsTeamsUpgradePolicy [[-Identity] <UserIdParameter>] [-PolicyName] <String> [-Tenant <Guid>]
19-
[-DomainController <Fqdn>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
20-
```
21-
22-
### GrantToTenant
23-
```
24-
Grant-CsTeamsUpgradePolicy [-PolicyName] <String> [-Tenant <Guid>] [-DomainController <Fqdn>]
25-
[-PassThru] [-Global] [-WhatIf] [-Confirm] [<CommonParameters>]
17+
Grant-CsTeamsUpgradePolicy [[-Identity] <UserIdParameter>] [-PolicyName] <string> [-Tenant <guid>] [-Confirm] [<CommonParameters>]
2618
```
2719

2820
## DESCRIPTION
29-
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. TeamsUpradePolicy 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.
21+
TeamsUpgradePolicy allows administrators to manage the transition from Skype for Business to Teams. As an organization with Skype for Business starts to adopt Teams, administrators can manage client behavior for their end user using the concept of coexistence "mode", which defines in which client chats and calls land. In the future, mode will also be used to define Teams client behavior in terms of what functionality will be available. 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.
22+
23+
This cmdlet enables admins to apply TeamsUpgradePolicy to either individual users or to set the default for the entire organization. TeamsUpgradePolicy can be granted either on a per user basis or on a tenant-wide basis.
24+
25+
26+
IMPORTANT: TeamsUpgradePolicy has replaced TeamsInteropPolicy. Components that previously honored TeamsInteropPolicy have been fully updated to honor TeamsUpgradePolicy instead. TeamsInteropPolicy is not honored, except if TeamsUpgradePolicy mode=Legacy. However, Legacy mode is being deprecated.
27+
28+
When you use Grant-CsTeamsUpgradePolicy you should NOT use Grant-CsTeamsInteropPolicy except if you choose mode=Legacy. Additionally, do not grant both policies at the same time. Instead grant one policy and then wait 30 minutes before granting the next policy.
3029

31-
IMPORTANT: TeamsUpgradePolicy will replace TeamsInteropPolicy. Components that previously honored TeamsInteropPolicy are being updated to honor TeamsUpgradePolicy instead. During the transition, use of these 2 policies must be coordinated during the transition. After transition is complete, TeamsInteorpPolicy will be removed.
3230

3331

34-
NOTES:
35-
All relevant instances of TeamsUpgradePolicy are built into the system, so there is no corresponding New cmdlet.
3632

37-
Instances with mode set to SfBWithTeamsCollab are not yet functional. From a routing perspective, this will behave like SfBOnly mode.
38-
When granting TeamsUpgradePolicy, you must also grant the corresponding instances of TeamsInteropPolicy as described later below.
33+
Office 365 provides all relevant instances of TeamsUpgradePolicy via built-in, read-only policies. The built-in instances are listed below.
34+
</br>
35+
</br>
36+
|Identity|Mode|NotifySfbUsers|Action|Comments|
37+
|---|---|---|---|---|
38+
|Islands|Islands|False|None||
39+
|IslandsWithNotify|Islands|True|Notify||
40+
|SfBOnly|SfBOnly|False|None|For now, this mode is effectively the same as setting preferred client=SfB. We expect in the future this will restrict Teams functionality.|
41+
|SfBOnlyWithNotify|SfBOnly|True|Notify|For now, this mode is effectively the same as setting preferred client=SfB. We expect in the future this will restrict Teams functionality.|
42+
|SfBWithTeamsCollab|SfBWithTeamsCollab|False|None|This mode exists at the PowerShell layer but is not yet exposed in the admin user experience. From a routing perspective, this is the same as SfBOnly mode. When TeamsAppPolicy is available, this will only allow Channels in Teams app.|
43+
|SfBWithTeamsCollabWithNotify|SfBWithTeamsCollab|True|Notify|This mode exists at the PowerShell layer but is not yet exposed in the admin user experience. From a routing perspective, this is the same as SfBOnly mode. When TeamsAppPolicy is available, this will only allow Channels in Teams app.|
44+
|UpgradeToTeams|TeamsOnly|False|Upgrade|Use this mode to upgrade users to Teams and to prevent chat, calling, and meeting scheduling in Skype for Business.|
45+
|Global|Legacy|False|None|The mode will soon be updated to Islands.|
46+
|NoUpgrade|Legacy|False|None|This instance will soon be retired.|
47+
|NotifyForTeams|Legacy|True|Notify|This instance will soon be retired.|
48+
||||||
49+
50+
51+
52+
NOTES:
53+
- TeamsUpgradePolicy is available in both Office 365 and in on-premises versions of Skype for Business Server, but there are differences:
54+
- In Office 365, admins can specify both coexistence mode and whether to trigger notifications of pending upgrade.
55+
- In on-premises with Skype for Business Server, the only availble option is to trigger notifications.
56+
- TeamsUpgradePolicy in Office 365 can be granted to users homed on-premises in hybrid deployments of Skype for Business as follows:
57+
- Coexistence mode is honored by users homed on-premises, however on-premises users cannot be granted the UpgradeToTeams instance (mode=TeamsOnly) of TeamsUpgradePolicy. Users must be either homed in Skype for Business Online or have no Skype account anywhere to be upgraded to TeamsOnly mode.
58+
- The NotifySfBUsers setting of Office 365 TeamsUpgradePolicy is not honored by users homed on-premises. Instead, the on-premise version of TeamsUpgradePolicy must be used.
59+
- In Office 365, all relevant instances of TeamsUpgradePolicy are built into the system, so there is no corresponding New cmdlet avaiable. In contrast, Skype for Business Server does not contain built-in instances, so the New cmdlet is available on-premises. Only NotifySfBUsers property is available in on-premises.
60+
- Instances with mode set to SfBWithTeamsCollab are not yet functional. From a routing perspective, this will behave like SfBOnly mode.
61+
- The Action property is redundnant with the combination of NotifySfBUsers and Mode. It will eventually be removed.
3962

4063

4164
## EXAMPLES
@@ -45,14 +68,14 @@ NOTES:
4568
PS C:\> Grant-CsTeamsUpgradePolicy -PolicyName UpgradeToTeams -Identity [email protected]
4669
```
4770

48-
The above cmdlet assigns the "UpgradeToTeams" policy to user [email protected]. This effectively upgrades the user to Teams only mode.
71+
The above cmdlet assigns the "UpgradeToTeams" policy to user [email protected]. This effectively upgrades the user to Teams only mode. This command will only succeed if the user does not have on-premises Skype for Business account.
4972

5073
### Example 2: Grant Policy to the entire tenant
5174
```
5275
PS C:\> Grant-CsTeamsUpgradePolicy -PolicyName SfBOnly
5376
```
5477

55-
To grant a policy to all users in the org (except any that have an explicit policy assinged), omit the idenity parameter.
78+
To grant a policy to all users in the org (except any that have an explicit policy assinged), omit the identity parameter.
5679

5780
## PARAMETERS
5881

@@ -64,23 +87,23 @@ To grant a policy to all users in the org (except any that have an explicit poli
6487
Type: UserIdParameter
6588
Parameter Sets: (All)
6689
Aliases:
67-
Applicable: Skype for Business Online
90+
Applicable: Skype for Business Online, Skype for Business Server 2019
6891

6992
Required: False
7093
Position: 0
7194
Default value: None
72-
Accept pipeline input: False
95+
Accept pipeline input: True
7396
Accept wildcard characters: False
7497
```
7598
7699
### -PolicyName
77100
{{Fill PolicyName Description}}
78101
79102
```yaml
80-
Type: String
103+
Type: Object
81104
Parameter Sets: (All)
82105
Aliases:
83-
Applicable: Skype for Business Online
106+
Applicable: Skype for Business Online, Skype for Business Server 2019
84107

85108
Required: False
86109
Position: 1
@@ -96,23 +119,7 @@ Prompts you for confirmation before running the cmdlet.
96119
Type: SwitchParameter
97120
Parameter Sets: (All)
98121
Aliases: cf
99-
Applicable: Skype for Business Online
100-
101-
Required: False
102-
Position: Named
103-
Default value: None
104-
Accept pipeline input: False
105-
Accept wildcard characters: False
106-
```
107-
108-
### -DomainController
109-
{{Fill DomainController Description}}
110-
111-
```yaml
112-
Type: Fqdn
113-
Parameter Sets: (All)
114-
Aliases:
115-
Applicable: Skype for Business Online
122+
Applicable: Skype for Business Online, Skype for Business Server 2019
116123

117124
Required: False
118125
Position: Named
@@ -121,30 +128,15 @@ Accept pipeline input: False
121128
Accept wildcard characters: False
122129
```
123130
124-
### -PassThru
125-
{{Fill PassThru Description}}
126-
127-
```yaml
128-
Type: SwitchParameter
129-
Parameter Sets: (All)
130-
Aliases:
131-
Applicable: Skype for Business Online
132-
133-
Required: False
134-
Position: Named
135-
Default value: None
136-
Accept pipeline input: False
137-
Accept wildcard characters: False
138-
```
139131
140132
### -Tenant
141133
{{Fill Tenant Description}}
142134
143135
```yaml
144-
Type: Guid
136+
Type: Object
145137
Parameter Sets: (All)
146138
Aliases:
147-
Applicable: Skype for Business Online
139+
Applicable: Skype for Business Online, Skype for Business Server 2019
148140

149141
Required: False
150142
Position: Named
@@ -153,38 +145,9 @@ Accept pipeline input: False
153145
Accept wildcard characters: False
154146
```
155147
156-
### -WhatIf
157-
Shows what would happen if the cmdlet runs.
158-
The cmdlet is not run.
159-
160-
```yaml
161-
Type: SwitchParameter
162-
Parameter Sets: (All)
163-
Aliases: wi
164-
Applicable: Skype for Business Online
165-
166-
Required: False
167-
Position: Named
168-
Default value: None
169-
Accept pipeline input: False
170-
Accept wildcard characters: False
171-
```
172148
173-
### -AsJob
174-
{{Fill AsJob Description}}
175149
176-
```yaml
177-
Type: SwitchParameter
178-
Parameter Sets: (All)
179-
Aliases:
180-
Applicable: Skype for Business Online
181150
182-
Required: False
183-
Position: Named
184-
Default value: None
185-
Accept pipeline input: False
186-
Accept wildcard characters: False
187-
```
188151
189152
## INPUTS
190153
@@ -197,20 +160,7 @@ Accept wildcard characters: False
197160
198161
## NOTES
199162
200-
When you grant TeamsUpgradePolicy to a user, you must also grant the corresponding instance of TeamsInteropPolicy to the user as shown below. Until TeamsInteropPolicy is retired, you must coordinate granting of both TeamsUpgradePolicy and TeamsInteropPolicy:
201-
202-
203-
| If you grant an instance of TeamsUpgradePolicy with this value of Mode…| …Then grant this instance of TeamsInteropPolicy |
204-
| :------------- |:-------------|
205-
| Islands | DisallowOverrideCallingDefaultChatDefault |
206-
| SfBonly, SfBWithTeamsCollab | DisallowOverrideCallingSfbChatSfb |
207-
| TeamsOnly | DisallowOverrideCallingTeamsChatTeams |
208-
209-
210-
211-
212-
213-
163+
It is *no longer required* to coordinate granting of TeamsUpgradePolicy and TeamsInteropPolicy. TeamsInteropPolicy is no longer honored and should not be used.
214164
215165
216166

0 commit comments

Comments
 (0)