See Also
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.
