Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inGrant-CsCallingLineIdentity
Use the Grant-CsCallingLineIdentity cmdlet to apply a Caller ID policy to a user account, to a group of users, or to set the tenant Global instance.
Grant-CsCallingLineIdentity
[[-PolicyName] <string>]
[-Global]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Grant-CsCallingLineIdentity
[-Group] <string>
[[-PolicyName] <string>]
[-PassThru]
[-Rank <int>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Grant-CsCallingLineIdentity
[[-Identity] <string>]
[[-PolicyName] <string>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
You can either assign a Caller ID policy to a specific user, to a group of users, or you can set the Global policy instance.
PS C:\> Grant-CsCallingLineIdentity -Identity Ken.Myer@contoso.com -PolicyName CallerIDRedmond
This example assigns the Caller ID policy with the Identity CallerIDRedmond to the user Ken.Myer@contoso.com
Grant-CsCallingLineIdentity -PolicyName CallerIDSeattle -Global
This example copies the Caller ID policy CallerIDSeattle to the Global policy instance.
Grant-CsCallingLineIdentity -Group sales@contoso.com -PolicyName CallerIDSeattle -Rank 10
This example assigns the Caller ID policy with the Identity CallerIDSeattle to the members of the group sales@contoso.com.
Applicable: Microsoft Teams
The Confirm switch causes the command to pause processing and requires confirmation to proceed.
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
Sets the parameters of the Global policy instance to the values in the specified policy instance.
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
(GrantToTenant)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
Specifies the group used for the group policy assignment.
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
GrantToGroup
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
The Identity of the user to whom the policy is being assigned. User Identities can be specified using the user's SIP address, the user's user principal name (UPN), or the user's ObjectId/Identity.
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
(Identity)
| Position: | 0 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
Enables you to pass a user object through the pipeline that represents the user being assigned the policy. By default, the Grant-CsCallingLineIdentity cmdlet does not pass objects through the pipeline.
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
The name (Identity) of the Caller ID policy to be assigned. To remove an existing user level policy assignment, specify PolicyName as $null.
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
The rank of the policy assignment, relative to other group policy assignments for the same policy type.
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
GrantToGroup
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
Applicable: Microsoft Teams
The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes.
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
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.
The GrantToGroup syntax is supported in Teams PowerShell Module 4.5.1-preview or later.