Commands › Microsoft Teams
Grant-CsTeamsUpgradePolicy
TeamsUpgradePolicy allows administrators to manage the transition from Skype for Business to Teams.
Quick start script
# Grant-CsTeamsUpgradePolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Run and inspect
Grant-CsTeamsUpgradePolicy -Group <String> | Format-List
# 3. Export for evidence / drift tracking
Grant-CsTeamsUpgradePolicy | Export-Clixml .\CsTeamsUpgradePolicy-$(Get-Date -Format yyyyMMdd).xmlSyntax — 3 parameter sets
Identity (Default)
Grant-CsTeamsUpgradePolicy [[-Identity] <String>] [-MigrateMeetingsToTeams <Boolean>] [-PassThru]
[[-PolicyName] <String>] [-MsftInternalProcessingMode <String>] [<CommonParameters>]GrantToTenant
Grant-CsTeamsUpgradePolicy [-MigrateMeetingsToTeams <Boolean>] [-PassThru] [[-PolicyName] <String>]
[-MsftInternalProcessingMode <String>] [-Force] [-Global] [<CommonParameters>]GrantToGroup
Grant-CsTeamsUpgradePolicy [-MigrateMeetingsToTeams <Boolean>] [-PassThru] [[-PolicyName] <String>]
[-MsftInternalProcessingMode <String>] -Group <String> [-Rank <Int32>]
[<CommonParameters>]Parameters (9)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Force | SwitchParameter | The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for... | |
| -Global | SwitchParameter | Use this switch if you want to grant the specified policy to be the default policy for all users in the tenant. | |
| -Group | String | yes | Specifies the group used for the group policy assignment. |
| -Identity | UserIdParameter | The user you want to grant policy to. This can be specified as SIP address, UserPrincipalName, or ObjectId. | |
| -MigrateMeetingsToTeams | Boolean | Not supported anymore, see the Description section. | |
| -PassThru | SwitchParameter | Enables you to pass a user object through the pipeline that represents the user account being assigned the Teams call hold policy. | |
| -PolicyName | Object | The name of the policy instance. | |
| -Rank | Int32 | The rank of the policy assignment, relative to other group policy assignments for the same policy type. | |
| -Tenant | Object | Do not use. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.