Topic Last Modified: 2013-02-20

Verifies the route and the PSTN usage used when routing a phone call made from a specified SIP trunk. This cmdlet was introduced in Lync Server 2013.

Syntax

Test-CsInterTrunkRouting -TargetNumber <PhoneNumber> -TrunkConfiguration <TrunkConfiguration> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]

Examples

Example 1

The commands shown in Example 1 return the matching routes and matching phone usages that enable users to call the phone number 1-206-555-1219 using the trunk configuration settings for the Redmond site.

Copy Code
$trunk = Get-CsTrunkConfiguration -Identity "site:Redmond"

Test-CsInterTrunkRouting -TargetNumber "tel:+12065551219" -TrunkConfiguration $trunk

Detailed Description

The Test-CsInterTrunkRouting verifies that calls can be routed from one SIP to another. To do this, the cmdlet is given a phone number and a trunk configuration; Test-CsInterTrunkRouting will then report back matching routes and matching PSTN usages for the specified number. Note that calls can be routed between trunks only if the trunks have a number pattern that matches the specified phone number and only if the trunks share at least one PSTN usage.

To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell command-line interface prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsInterTrunkRouting"}

Lync Server Control Panel: The functions carried out by the Test-CsInterTrunkRouting cmdlet are not available in the Lync Server Control Panel.

Parameters

Parameter Required Type Description

TargetNumber

Required

Microsoft.Rtc.Management.Voice.PhoneNumber

PSTN telephone number to be called when conducting the test. The target phone number should specified using the E.164 format, which means that the number will look something like this:

-TargetNumber "tel:+12065551219"

The phone number should include the "tel:" prefix followed by a plus sign (+), the country/region calling code (1), the area code (206) and the phone number (5551219). Do not use dashes, parentheses, or any other characters when specifying the phone number.

TrunkConfiguration

Required

Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration

Object reference to the trunk configuration being tested. To create this object reference, use a command similar to this:

$trunk = Get-CsTrunkConfiguration –Identity "site:Redmond"

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any non-fatal error message that might arise when running the command.

RouteSettings

Optional

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings

Object reference that enables you to specify a collection of voice routing configuration settings when calling Test-CsInterTrunkRouting. To create this object reference, use a command similar to this:

$route = Get-CsRoutingConfiguration –Identity "global"

Input Types

None. Test-CsInterTrunkRouting does not accept pipelined input.

Return Types

Test-CsInterTrunkRouting returns instances of the Microsoft.Rtc.Management.Voice.InterTrunkRoutingTestResult object.

See Also