Edit

Share via

Get-CsTenantDialPlan

Module:
MicrosoftTeams PowerShell module

Use the Get-CsTenantDialPlan cmdlet to retrieve a tenant dial plan.

Syntax

Identity (Default) 

Get-CsTenantDialPlan
    [[-Identity] <string>]
    [<CommonParameters>]

Filter 

Get-CsTenantDialPlan
    [-Filter <String>]
    [<CommonParameters>]

Description

The Get-CsTenantDialPlan cmdlet returns information about one or more tenant dial plans (also known as a location profiles) in an organization. Tenant dial plans provide required information to let Enterprise Voice users make telephone calls. The Conferencing Attendant application also uses tenant dial plans for dial-in conferencing. A tenant dial plan determines such things as which normalization rules are applied.

You can use the Get-CsTenantDialPlan cmdlet to retrieve specific information about the normalization rules of a tenant dial plan.

Examples

Example 1

Get-CsTenantDialPlan

This example retrieves all existing tenant dial plans.

Example 2

Get-CsTenantDialPlan -Identity Vt1TenantDialPlan2

This example retrieves the tenant dial plan that has an identity of Vt1TenantDialplan2.

Parameters

-Filter

Applicable: Microsoft Teams

The Filter parameter allows you to limit the number of results based on filters you specify.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(Filter)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: Microsoft Teams

The Identity parameter is a unique identifier that designates the name of the tenant dial plan to retrieve.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(Identity)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

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.

Notes

The ExternalAccessPrefix and OptimizeDeviceDialing parameters have been removed from New-CsTenantDialPlan and Set-CsTenantDialPlan cmdlet since they are no longer used. External access dialing is now handled implicitly using normalization rules of the dial plans. The Get-CsTenantDialPlan will still show the external access prefix in the form of a normalization rule of the dial plan.