Get-CsVoiceRoutingPolicy

Syntax

Get-CsVoiceRoutingPolicy
   [[-Identity] <XdsIdentity>]
   [-LocalStore]
   [<CommonParameters>]

Get-CsVoiceRoutingPolicy
   [-Filter <String>]
   [-LocalStore]
   [<CommonParameters>]

Description

Voice routing policies are used in "hybrid" scenarios: when some of your users are homed on the on-premises version of Skype for Business Server and other users are homed on Skype for Business Online. Assigning your Skype for Business Online users a voice routing policy enables those users to receive and to place phones calls to the public switched telephone network by using your on-premises SIP trunks.

Note that simply assigning a user a voice routing policy will not enable them to make PSTN calls via Skype for Business Online. Among other things, you will also need to enable those users for Enterprise Voice and will need to assign them an appropriate voice policy and dial plan.

The functions carried out by the Get-CsVoiceRoutingPolicy cmdlet are not available in the Skype for Business Server Control Panel.

Examples

-------------------------- Example 1 --------------------------

Get-CsVoiceRoutingPolicy

The command shown in Example 1 returns information for all the voice routing policies configured for use in the organization.

-------------------------- Example 2 --------------------------

Get-CsVoiceRoutingPolicy -Identity "RedmondVoiceRoutingPolicy"

In Example 2, information is returned for a single voice routing policy: the policy with the Identity RedmondVoiceRoutingPolicy.

-------------------------- Example 3 --------------------------

Get-CsVoiceRoutingPolicy -Filter "tag:*"

The command shown in Example 3 returns information about all the voice routing policies configured at the per-user scope. To do this, the command uses the Filter parameter and the filter value "tag:*"; that filter value limits the returned data to policies that have an Identity that begins with the string value "tag:".

-------------------------- Example 4 --------------------------

Get-CsVoiceRoutingPolicy | Where-Object {$_.PstnUsages -contains "Long Distance"}

In Example 4, information is returned only for those voice routing policies that include the PSTN usage "Long Distance". To carry out this task, the command first calls Get-CsVoiceRoutingPolicy without any parameters; that returns a collection of all the voice routing policies configured for use in the organization. This collection is then piped to the Where-Object cmdlet, which picks out only those policies where the PstnUsages property includes (-contains) the usage "Long Distance".

-------------------------- Example 5 --------------------------

Get-CsVoiceRoutingPolicy | Where-Object {$_.PstnUsages -notcontains "Long Distance"}

Example 5 is a variation on the command shown in Example 4; in this case, however, information is returned only for those voice routing policies that do not include the PSTN usage "Long Distance". In order to do that, the Where-Object cmdlet uses the -notcontains operator, which limits returned data to policies that do not include the usage "Long Distance".

Parameters

-Filter

-Identity

-LocalStore

Inputs

None. The Get-CsVoiceRoutingPolicy cmdlet does not accept pipelined input.

Outputs

The Get-CsVoiceRoutingPolicy cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceRoutingPolicy object.

Related Links

• Grant-CsVoiceRoutingPolicy
• New-CsVoiceRoutingPolicy
• Remove-CsVoiceRoutingPolicy
• Set-CsVoiceRoutingPolicy