|
| 1 | +--- |
| 2 | +external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml |
| 3 | +Module Name: MicrosoftTeams, Skype for Business Server 2019, Skype for Business Server 2015 |
| 4 | +title: Get-CsTeamsUpgradePolicy |
| 5 | +schema: 2.0.0 |
| 6 | +manager: bulenteg |
| 7 | +author: tomkau |
| 8 | +ms.author: tomkau |
| 9 | +ms.reviewer: rogupta |
| 10 | +--- |
| 11 | + |
| 12 | +# Get-CsTeamsUpgradePolicy |
| 13 | + |
| 14 | +## SYNOPSIS |
| 15 | +TeamsUpgradePolicy allows administrators to manage the transition from Skype for Business to Teams. |
| 16 | + |
| 17 | + |
| 18 | +## SYNTAX |
| 19 | + |
| 20 | +### Identity (Default) |
| 21 | +``` |
| 22 | +Get-CsTeamsUpgradePolicy [-Tenant <Guid>] [[-Identity] <XdsIdentity>] [-LocalStore] [<CommonParameters>] |
| 23 | +``` |
| 24 | + |
| 25 | +### Filter |
| 26 | +``` |
| 27 | +Get-CsTeamsUpgradePolicy [-Tenant <Guid>] [-Filter <String>] [-LocalStore] [<CommonParameters>] |
| 28 | +``` |
| 29 | + |
| 30 | +## DESCRIPTION |
| 31 | +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 the user experience in their organization using the concept of coexistence "mode". Mode defines in which client incoming chats and calls land as well as in what service (Teams or Skype for Business) new meetings are scheduled in. Mode also governs whether chat, calling, and meeting scheduling functionality are available in the Teams client. Finally, 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. |
| 32 | + |
| 33 | +NOTES: |
| 34 | + - Except for on-premise versions of Skype for Business Server, all relevant instances of TeamsUpgradePolicy are built into the system, so there is no corresponding New cmdlet. |
| 35 | + - If you are using Skype for Business Server, there are no built-in instances and you'll need to create one. Also, only the NotifySfBUsers property is available. Mode is not present. |
| 36 | + - Using TeamsUpgradePolicy in an on-premises environmention requires Skype for Business Server 2015 with CU8 or later. |
| 37 | + |
| 38 | +You can also find more guidance here: [Migration and interoperability guidance for organizations using Teams together with Skype for Business](https://docs.microsoft.com/microsoftteams/migration-interop-guidance-for-teams-with-skype). |
| 39 | + |
| 40 | +## EXAMPLES |
| 41 | + |
| 42 | +### Example 1: List all instances of TeamsUpgradePolicy (Skype for Business Online) |
| 43 | +``` |
| 44 | +PS C:\> Get-CsTeamsUpgradePolicy |
| 45 | +
|
| 46 | +Identity : Global |
| 47 | +Description : Users can use either Skype for Business client or Teams client |
| 48 | +Mode : Islands |
| 49 | +NotifySfbUsers : False |
| 50 | +
|
| 51 | +Identity : Tag:UpgradeToTeams |
| 52 | +Description : Use Teams Only |
| 53 | +Mode : TeamsOnly |
| 54 | +NotifySfbUsers : False |
| 55 | +
|
| 56 | +Identity : Tag:Islands |
| 57 | +Description : Use either Skype for Business client or Teams client |
| 58 | +Mode : Islands |
| 59 | +NotifySfbUsers : False |
| 60 | +Action : None |
| 61 | +
|
| 62 | +Identity : Tag:IslandsWithNotify |
| 63 | +Description : Use either Skype for Business client or Teams client |
| 64 | +Mode : Islands |
| 65 | +NotifySfbUsers : True |
| 66 | +
|
| 67 | +Identity : Tag:SfBOnly |
| 68 | +Description : Use only Skype for Business |
| 69 | +Mode : SfBOnly |
| 70 | +NotifySfbUsers : False |
| 71 | +
|
| 72 | +Identity : Tag:SfBOnlyWithNotify |
| 73 | +Description : Use only Skype for Business |
| 74 | +Mode : SfBOnly |
| 75 | +NotifySfbUsers : True |
| 76 | +
|
| 77 | +Identity : Tag:SfBWithTeamsCollab |
| 78 | +Description : Use Skype for Business and use Teams only for group collaboration |
| 79 | +Mode : SfBWithTeamsCollab |
| 80 | +NotifySfbUsers : False |
| 81 | +
|
| 82 | +Identity : Tag:SfBWithTeamsCollabWithNotify |
| 83 | +Description : Use Skype for Business and use Teams only for group collaboration |
| 84 | +Mode : SfBWithTeamsCollab |
| 85 | +NotifySfbUsers : True |
| 86 | +
|
| 87 | +Identity : Tag:SfBWithTeamsCollabAndMeetings |
| 88 | +Description : Use Skype for Business and use Teams only for group collaboration |
| 89 | +Mode : SfBWithTeamsCollabAndMeetings |
| 90 | +NotifySfbUsers : False |
| 91 | +
|
| 92 | +Identity : Tag:SfBWithTeamsCollabAndMeetingsWithNotify |
| 93 | +Description : Use Skype for Business and use Teams only for group collaboration |
| 94 | +Mode : SfBWithTeamsCollabAndMeetings |
| 95 | +NotifySfbUsers : True |
| 96 | +``` |
| 97 | + |
| 98 | +List all instances of TeamsUpgradePolicy |
| 99 | + |
| 100 | + |
| 101 | +### Example 2: List the global instance of TeamsUpgradePolicy (which applies to all users in a tenant unless they are explicitly assigned an instance of this policy) |
| 102 | +``` |
| 103 | +PS C:\> Get-CsTeamsUpgradePolicy -Identity Global |
| 104 | +
|
| 105 | +Identity : Global |
| 106 | +Description : Users can use either Skype for Business client or Teams client |
| 107 | +Mode : Islands |
| 108 | +NotifySfbUsers : False |
| 109 | +
|
| 110 | +``` |
| 111 | + |
| 112 | +List the global instance of TeamsUpgradePolicy |
| 113 | + |
| 114 | +### Example 3: List all instances of TeamsUpgradePolicy in an on-premises environment |
| 115 | +``` |
| 116 | +PS C:\> Get-CsTeamsUpgradePolicy -Identity Global |
| 117 | +
|
| 118 | +Identity : Global |
| 119 | +Description : Notifications are disabled |
| 120 | +NotifySfbUsers : False |
| 121 | +
|
| 122 | +``` |
| 123 | + |
| 124 | +List all on-premises instances (if any) of TeamsUpgradePolicy. |
| 125 | + |
| 126 | +## PARAMETERS |
| 127 | + |
| 128 | +### -Identity |
| 129 | +If identity parameter is passed, this will return a specific instance. If no identity parameter is specified, the cmdlet returns all instances. |
| 130 | + |
| 131 | +```yaml |
| 132 | +Type: XdsIdentity |
| 133 | +Parameter Sets: (All) |
| 134 | +Aliases: |
| 135 | +Module Name: MicrosoftTeams, Skype for Business Server 2019, Skype for Business Server 2015 |
| 136 | + |
| 137 | +Required: False |
| 138 | +Position: 1 |
| 139 | +Default value: None |
| 140 | +Accept pipeline input: False |
| 141 | +Accept wildcard characters: False |
| 142 | +``` |
| 143 | +### -Filter |
| 144 | +{{Fill Filter Description}} |
| 145 | +
|
| 146 | +```yaml |
| 147 | +Type: String |
| 148 | +Parameter Sets: (All) |
| 149 | +Aliases: |
| 150 | +Module Name: MicrosoftTeams, Skype for Business Server 2019, Skype for Business Server 2015 |
| 151 | + |
| 152 | +Required: False |
| 153 | +Position: Named |
| 154 | +Default value: None |
| 155 | +Accept pipeline input: False |
| 156 | +Accept wildcard characters: False |
| 157 | +``` |
| 158 | +
|
| 159 | +
|
| 160 | +### -Tenant |
| 161 | +{{Fill Tenant Description}} |
| 162 | +
|
| 163 | +```yaml |
| 164 | +Type: Guid |
| 165 | +Parameter Sets: (All) |
| 166 | +Aliases: |
| 167 | +Module Name: MicrosoftTeams, Skype for Business Server 2019, Skype for Business Server 2015 |
| 168 | + |
| 169 | +Required: False |
| 170 | +Position: Named |
| 171 | +Default value: None |
| 172 | +Accept pipeline input: False |
| 173 | +Accept wildcard characters: False |
| 174 | +``` |
| 175 | +
|
| 176 | +### CommonParameters |
| 177 | +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. |
| 178 | +For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216). |
| 179 | +
|
| 180 | +## INPUTS |
| 181 | +
|
| 182 | +### None |
| 183 | +## OUTPUTS |
| 184 | +
|
| 185 | +### System.Object |
| 186 | +## NOTES |
| 187 | +
|
| 188 | +## RELATED LINKS |
| 189 | +
|
| 190 | +[Get-CsTeamsUpgradeConfiguration](Get-CsTeamsUpgradeConfiguration.md) |
| 191 | +
|
| 192 | +[Set-CsTeamsUpgradeConfiguration](Set-CsTeamsUpgradeConfiguration.md) |
| 193 | +
|
| 194 | +[Grant-CsTeamsUpgradePolicy](Grant-CsTeamsUpgradePolicy.md) |
| 195 | +
|
| 196 | +[Migration and interoperability guidance for organizations using Teams together with Skype for Business](https://docs.microsoft.com/MicrosoftTeams/migration-interop-guidance-for-teams-with-skype) |
| 197 | +
|
0 commit comments