Commands › Microsoft Teams
Grant-CsTeamsSharedCallingRoutingPolicy
Assigns a specific Teams shared calling routing policy to a user, a group of users, or sets the Global policy instance.
Quick start script
# Grant-CsTeamsSharedCallingRoutingPolicy — 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-CsTeamsSharedCallingRoutingPolicy -Group <String> -Identity <String> | Format-List
# 3. Export for evidence / drift tracking
Grant-CsTeamsSharedCallingRoutingPolicy | Export-Clixml .\CsTeamsSharedCallingRoutingPolicy-$(Get-Date -Format yyyyMMdd).xmlSyntax — 4 parameter sets
Identity (Default)
Grant-CsTeamsSharedCallingRoutingPolicy [<CommonParameters>]GrantToUser
Grant-CsTeamsSharedCallingRoutingPolicy [[-PolicyName] <string>] -Identity <string> [<CommonParameters>]GrantToTenant
Grant-CsTeamsSharedCallingRoutingPolicy -Global [[-PolicyName] <string>] [-Force] [<CommonParameters>]GrantToGroup
Grant-CsTeamsSharedCallingRoutingPolicy [-Group] <string> [[-PolicyName] <string>] -Rank <int> [<CommonParameters>]Parameters (6)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Force | SwitchParameter | Suppresses any confirmation prompts that would otherwise be displayed before making changes. | |
| -Global | SwitchParameter | When you use this cmdlet without specifying a user identity, the policy applies to all users in your organization, except any that have an explicit policy assignment. To prevent a warning when you carry out this... | |
| -Group | String | yes | Specifies the group used for the group policy assignment. |
| -Identity | String | yes | Indicates the Identity of the user account to be assigned the per-user Teams shared calling routing policy. User identities can be specified using one of the following formats: the user's SIP address, the user's user... |
| -PolicyName | String | Name of the policy to be assigned. The PolicyName is simply the policy Identity minus the policy scope (the "tag:" prefix). For example, a policy with the Identity tag:Seattle has a PolicyName equal to Seattle. | |
| -Rank | Int32 | The rank of the policy assignment, relative to other group policy assignments for the same policy type. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.