Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Grant-CsTeamsCallingPolicy
- Module:
- MicrosoftTeams PowerShell module
Assigns a specific Teams Calling Policy to a user, a group of users, or sets the Global policy instance.
Syntax
Identity (Default)
Grant-CsTeamsCallingPolicy
[[-Identity] <string>]
[[-PolicyName] <string>]
[-PassThru]
[<CommonParameters>]
GrantToTenant
Grant-CsTeamsCallingPolicy
[[-PolicyName] <string>]
[-PassThru]
[-Global]
[<CommonParameters>]
GrantToGroup
Grant-CsTeamsCallingPolicy
[-Group] <string>
[[-PolicyName] <string>]
[-PassThru]
[-Rank <int>]
[<CommonParameters>]
Description
The Teams Calling Policies designate how users are able to use calling functionality within Microsoft Teams. This cmdlet allows admins to grant user level policies to individual users, to members of a group, or to set the Global policy instance.
Examples
Example 1
Grant-CsTeamsCallingPolicy -identity user1@contoso.com -PolicyName SalesCallingPolicy
Assigns the TeamsCallingPolicy called "SalesCallingPolicy" to user1@contoso.com
Example 2
Grant-CsTeamsCallingPolicy -Global -PolicyName SalesCallingPolicy
Assigns the TeamsCallingPolicy called "SalesCallingPolicy" to the Global policy instance. This sets the parameters in the Global policy instance to the values found in the SalesCallingPolicy instance.
Example 3
Grant-CsTeamsCallingPolicy -Group sales@contoso.com -Rank 10 -PolicyName SalesCallingPolicy
Assigns the TeamsCallingPolicy called "SalesCallingPolicy" to the members of the group sales@contoso.com.
Parameters
-Global
Sets the parameters of the Global policy instance to the values in the specified policy instance.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Group
Specifies the group used for the group policy assignment.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Identity
The user object to whom the policy is being assigned.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PassThru
Enables you to pass a user object through the pipeline that represents the user being assigned the policy. By default, the Grant-CsTeamsCallingPolicy cmdlet does not pass objects through the pipeline.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PolicyName
The name of the policy being assigned. To remove an existing user level policy assignment, specify PolicyName as $null.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Rank
The rank of the policy assignment, relative to other group policy assignments for the same policy type.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Outputs
System.Object
Notes
The GrantToGroup syntax is supported in Teams PowerShell Module 4.5.1-preview or later.
Related Links
Feedback
Was this page helpful?