Commands › Microsoft Teams

Grant-CsTenantDialPlan

Assign an existing tenant dial plan to a user, to a group of users, or to set the Global policy instance.

Quick start script

# Grant-CsTenantDialPlan — 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-CsTenantDialPlan -Group <String> | Format-List

# 3. Export for evidence / drift tracking
Grant-CsTenantDialPlan | Export-Clixml .\CsTenantDialPlan-$(Get-Date -Format yyyyMMdd).xml

Syntax — 3 parameter sets

GrantToTenant (Default)

Grant-CsTenantDialPlan [[-PolicyName] <string>] [-Global] [-PassThru] [<CommonParameters>]

GrantToGroup

Grant-CsTenantDialPlan [-Group] <string> [[-PolicyName] <string>] [-PassThru] [-Rank <int>] [<CommonParameters>]

Identity

Grant-CsTenantDialPlan [[-Identity] <string>] [[-PolicyName] <string>] [-PassThru] [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Global	SwitchParameter		Sets the parameters of the Global policy instance to the values in the specified policy instance.
-Group	String	yes	Specifies the group used for the group policy assignment.
-Identity	String		The Identity parameter identifies the user to whom the policy should be assigned.
-PassThru	SwitchParameter		{{ Fill PassThru Description }}
-PolicyName	String		The PolicyName parameter is the name of the tenant dial plan to be assigned.
-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.