Test-CsInterTrunkRouting

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]
    [-RouteSettings <PstnRoutingSettings>]
    [<CommonParameters>]

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.

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

Examples

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

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

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

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.

Parameters

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-RouteSettings

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"

Type:PstnRoutingSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-TargetNumber

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.

Type:PhoneNumber
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-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"

Type:TrunkConfiguration
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

None. Test-CsInterTrunkRouting does not accept pipelined input.

Outputs

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