Edit

Share via

Grant-CsTeamsSharedCallingRoutingPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

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 "[email protected]" -PolicyName "Seattle"

The command shown in Example 1 assigns the per-user Teams shared calling routing policy instance Seattle to the user [email protected].

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.