Commands › Microsoft Teams

Grant-CsDialoutPolicy

Assign the tenant global or a per-user outbound calling restriction policy to one or more users.

Quick start script

# Grant-CsDialoutPolicy — 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-CsDialoutPolicy | Format-List

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

Syntax — 2 parameter sets

Identity (Default)

Grant-CsDialoutPolicy [[-Identity] <string>] [[-PolicyName] <string>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

GrantToTenant

Grant-CsDialoutPolicy [[-PolicyName] <string>] [-PassThru] [-Global] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (6)

Parameter	Type	What it controls
-Confirm	SwitchParameter	Prompts you for confirmation before running the cmdlet.
-Global	SwitchParameter	This parameter sets the tenant global policy instance. This is the policy that all users in the tenant will get unless they have a specific policy instance assigned.
-Identity	String	Specifies the Identity of the user account to be to be modified. A user identity can be specified by using one of three formats: 1) the user's SIP address; 2) the user's user principal name (UPN); 3) the user's...
-PassThru	SwitchParameter	Returns the results of the command. By default, this cmdlet does not generate any output.
-PolicyName	String	"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:DialoutCPCZoneAPSTNDomestic has a PolicyName...
-WhatIf	SwitchParameter	Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.