Edit

Share via


Get-CsOnlineDialOutPolicy

Use the Get-CsOnlineDialOutPolicy cmdlet to get all the available outbound calling restriction policies in your organization.

Syntax

Identity (Default)

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

Filter

Get-CsOnlineDialOutPolicy
    [-Filter <string>]
    [<CommonParameters>]

Description

In Microsoft Teams, outbound calling restriction policies are used to restrict the type of audio conferencing and end user PSTN calls that can be made by users in your organization. The policies apply to all the different PSTN connectivity options for Microsoft Teams; Calling Plan, Direct Routing, and Operator Connect.

To get all the available policies in your organization run Get-CsOnlineDialOutPolicy. To assign one of these policies to a user run Grant-CsDialoutPolicy.

Examples

Example 1

Get-CsOnlineDialOutPolicy

In Example 1, Get-CsOnlineDialOutPolicy is called without any additional parameters; this returns a collection of all the outbound calling restriction policies configured for use in your organization.

Example 2

Get-CsOnlineDialOutPolicy -Identity DialoutCPCandPSTNDisabled

In Example 2, Get-CsOnlineDialOutPolicy is used to return the per-user outbound calling restriction policy that has an Identity DialoutCPCandPSTNDisabled. Because identities are unique, this command will never return more than one item.

Parameters

-Filter

Enables you to use wildcard characters when indicating the policy (or policies) to be returned. To return a collection of all the per-user policies, use this syntax: -Filter "tag:*".

Parameter properties

Type:String
Default value:None
Supports wildcards:True
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

Unique identifier of the outbound calling restriction policy to be returned. To refer to the global policy, use this syntax: "-Identity Global". To refer to a per-user policy, use syntax similar to this: -Identity DialoutCPCandPSTNDisabled.

If this parameter is omitted, then all the outbound calling restriction policies configured for use in your tenant will be returned.

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.

Inputs

None

Outputs

System.Object