Test-CsTrunkConfiguration
Validates a trunk configuration against a phone number. This cmdlet was introduced in Lync Server 2010.
Syntax
Test-CsTrunkConfiguration
-DialedNumber <PhoneNumber>
-TrunkConfiguration <TrunkConfiguration>
[-CallingNumber <PhoneNumber>]
[<CommonParameters>]
Description
Use this cmdlet to verify that a trunking configuration performs as expected against a dialed phone number. Each configuration contains specific settings defining the relationship and capabilities between the Mediation Server and the public switched telephone network (PSTN) gateway, IP-public branch exchange (PBX), or Session Border Controller (SBC) at the service provider. These settings configure such things as whether media bypass is enabled on this trunk, whether real-time transport control protocol (RTCP) packets are sent under certain conditions, and whether to require secure real-time protocol (SRTP) encryption.
Examples
-------------------------- Example 1 --------------------------
$tc = Get-CsTrunkConfiguration -Identity Site:Redmond
Test-CsTrunkConfiguration -DialedNumber 4255551212 -TrunkConfiguration $tc
This example runs a test against the trunk configuration defined for the Redmond site.
The first line in this example calls the Get-CsTrunkConfiguration
cmdlet to retrieve the configuration for the Redmond site (the configuration with the Identity site:Redmond).
The trunk configuration object retrieved is assigned to the variable $tc.
In line 2 we call the Test-CsTrunkConfiguration
cmdlet, passing the phone number to test to the DialedNumber parameter, and the trunk configuration we retrieved in line 1 (stored in $tc) to the TrunkConfiguration parameter.
Parameters
-CallingNumber
When specified, returns the matched outbound translation rules for the specified phone number. For example:
-CallingNumber "tel:+14255551219"
Type: | PhoneNumber |
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 |
-DialedNumber
The phone number against which to test the configuration.
Type: | PhoneNumber |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-TrunkConfiguration
A reference to a trunk configuration object against which to run the test.
Trunk configuration objects can be retrieved by calling the Get-CsTrunkConfiguration
cmdlet.
Type: | TrunkConfiguration |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration object. Accepts pipelined input of a trunk configuration object.
Outputs
Returns a value of type Microsoft.Rtc.Management.Voice.TrunkConfigurationTestResult.