Skip to content

Commit 45cc573

Browse files
authored
Merge pull request MicrosoftDocs#1213 from bjwhalen/patch-7
Update Grant-CsTeamsUpgradePolicy.md
2 parents 21e78c9 + e83b5bc commit 45cc573

File tree

1 file changed

+37
-74
lines changed

1 file changed

+37
-74
lines changed

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

Lines changed: 37 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -14,25 +14,48 @@ TeamsUpgradePolicy allows administrators to manage the transition from Skype for
1414
## SYNTAX
1515

1616
```
17-
Grant-CsTeamsUpgradePolicy [[-PolicyName] <Object>] [[-Identity] <Object>]
18-
[-Tenant <Object>][-PassThru] [-Confirm] [-DomainController <Object>] [-WhatIf] [-AsJob]
19-
```
20-
21-
```
22-
Grant-CsTeamsUpgradePolicy [[-Identity] <UserIdParameter>] [-PolicyName] <string> [-Tenant <guid>] [-DomainController <Fqdn>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
17+
Grant-CsTeamsUpgradePolicy [[-Identity] <UserIdParameter>] [-PolicyName] <string> [-Tenant <guid>] [-Confirm] [<CommonParameters>]
2318
```
2419

2520
## DESCRIPTION
26-
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.
2722

28-
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.
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.
2924

3025

31-
NOTES:
32-
All relevant instances of TeamsUpgradePolicy are built into the system, so there is no corresponding New cmdlet.
26+
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, TeamsInteropPolicy will be removed.
3327

34-
Instances with mode set to SfBWithTeamsCollab are not yet functional. From a routing perspective, this will behave like SfBOnly mode.
35-
When granting TeamsUpgradePolicy, you must also grant the corresponding instances of TeamsInteropPolicy as described later below.
28+
|||||
29+
30+
Office 365 provides all relevant instances of TeamsUpgradePolicy via built-in, read-only policies. The built-in instances are listed below.
31+
</br>
32+
</br>
33+
|Identity|Mode|NotifySfbUsers|Action|Comments|
34+
|---|---|---|---|---|
35+
|Islands|Islands|False|None||
36+
|IslandsWithNotify|Islands|True|Notify||
37+
|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.|
38+
|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.|
39+
|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.|
40+
|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.|
41+
|UpgradeToTeams|TeamsOnly|False|Upgrade|Use this mode to upgrade users to Teams and to prevent chat, calling, and meeting scheduling in Skype for Business.|
42+
|Global|Legacy|False|None|The mode will eventually be updated to Islands.|
43+
|NoUpgrade|Legacy|False|None|This instance will eventually be retired.|
44+
|NotifyForTeams|Legacy|True|Notify|This instance will eventually be retired.|
45+
||||||
46+
47+
48+
49+
NOTES:
50+
- TeamsUpgradePolicy is available in both Office 365 and in on-premises versions of Skype for Business Server, but there are differences:
51+
- In Office 365, admins can specify both coexistence mode and whether to trigger notifications of pending upgrade.
52+
- In on-premises with Skype for Business Server, the only availble option is to trigger notifications.
53+
- TeamsUpgradePolicy in Office 365 can be granted to users homed on-premises in hybrid deployments of Skype for Business as follows:
54+
- 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.
55+
- 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.
56+
- 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.
57+
- Instances with mode set to SfBWithTeamsCollab are not yet functional. From a routing perspective, this will behave like SfBOnly mode.
58+
- The Action property is redundnant with the combination of NotifySfBUsers and Mode. It will eventually be removed.
3659

3760

3861
## EXAMPLES
@@ -42,14 +65,14 @@ NOTES:
4265
PS C:\> Grant-CsTeamsUpgradePolicy -PolicyName UpgradeToTeams -Identity [email protected]
4366
```
4467

45-
The above cmdlet assigns the "UpgradeToTeams" policy to user [email protected]. This effectively upgrades the user to Teams only mode.
68+
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.
4669

4770
### Example 2: Grant Policy to the entire tenant
4871
```
4972
PS C:\> Grant-CsTeamsUpgradePolicy -PolicyName SfBOnly
5073
```
5174

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

5477
## PARAMETERS
5578

@@ -102,37 +125,6 @@ Accept pipeline input: False
102125
Accept wildcard characters: False
103126
```
104127
105-
### -DomainController
106-
{{Fill DomainController Description}}
107-
108-
```yaml
109-
Type: Object
110-
Parameter Sets: (All)
111-
Aliases:
112-
Applicable: Skype for Business Online, Skype for Business Server 2019
113-
114-
Required: False
115-
Position: Named
116-
Default value: None
117-
Accept pipeline input: False
118-
Accept wildcard characters: False
119-
```
120-
121-
### -PassThru
122-
{{Fill PassThru Description}}
123-
124-
```yaml
125-
Type: SwitchParameter
126-
Parameter Sets: (All)
127-
Aliases:
128-
Applicable: Skype for Business Online, Skype for Business Server 2019
129-
130-
Required: False
131-
Position: Named
132-
Default value: None
133-
Accept pipeline input: False
134-
Accept wildcard characters: False
135-
```
136128
137129
### -Tenant
138130
{{Fill Tenant Description}}
@@ -150,38 +142,9 @@ Accept pipeline input: False
150142
Accept wildcard characters: False
151143
```
152144
153-
### -WhatIf
154-
Shows what would happen if the cmdlet runs.
155-
The cmdlet is not run.
156145
157-
```yaml
158-
Type: SwitchParameter
159-
Parameter Sets: (All)
160-
Aliases: wi
161-
Applicable: Skype for Business Online, Skype for Business Server 2019
162146
163-
Required: False
164-
Position: Named
165-
Default value: None
166-
Accept pipeline input: False
167-
Accept wildcard characters: False
168-
```
169-
170-
### -AsJob
171-
{{Fill AsJob Description}}
172-
173-
```yaml
174-
Type: SwitchParameter
175-
Parameter Sets: (All)
176-
Aliases:
177-
Applicable: Skype for Business Online, Skype for Business Server 2019
178147
179-
Required: False
180-
Position: Named
181-
Default value: None
182-
Accept pipeline input: False
183-
Accept wildcard characters: False
184-
```
185148
186149
## INPUTS
187150

0 commit comments

Comments
 (0)