Grant-CsTeamsSharedCallingRoutingPolicy
Assigns a specific Teams shared calling routing policy to a user, a group of users, or sets the Global policy instance.
Syntax
Grant-CsTeamsSharedCallingRoutingPolicy []
Grant-CsTeamsSharedCallingRoutingPolicy
[[-PolicyName] <string>]
-Identity <string>
[<CommonParameters>]
Grant-CsTeamsSharedCallingRoutingPolicy
-Global
[[-PolicyName] <string>]
[-Force]
[<CommonParameters>]
Grant-CsTeamsSharedCallingRoutingPolicy
[-Group] <string>
[[-PolicyName] <string>]
-Rank <int>
[<CommonParameters>]
Examples
EXAMPLE 1
Grant-CsTeamsSharedCallingRoutingPolicy -Identity "user@contoso.com" -PolicyName "Seattle"
The command shown in Example 1 assigns the per-user Teams shared calling routing policy instance Seattle to the user user@contoso.com.
EXAMPLE 2
Grant-CsTeamsSharedCallingRoutingPolicy -PolicyName "Seattle" -Global
Example 2 assigns the per-user Teams shared calling routing policy instance Seattle to all the users in the organization, except any that have an explicit Teams shared calling routing policy assignment.
Parameters
-Force
Suppresses any confirmation prompts that would otherwise be displayed before making changes.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Microsoft Teams |
-Global
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 operation, specify this parameter.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Group
Specifies the group used for the group policy assignment.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Identity
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 principal name (UPN), or the user's ObjectId or Identity.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyName
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.
To unassign a per-user policy previously assigned to a user, set the PolicyName to a null value ($Null).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Rank
The rank of the policy assignment, relative to other group policy assignments for the same policy type.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Notes
This cmdlet was introduced in Teams PowerShell Module 5.5.0.