[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Returns information about the voice routes configured for use in an organization.


Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceRoute [-Filter <String>] [-LocalStore <SwitchParameter>]


Parameter Required Type Description




A string that uniquely identifies the voice route. If no identity is provided, all voice routes for the organization are returned.




This parameter filters the results of the Get operation based on the wildcard value passed to this parameter.




Retrieves the voice route from the local replica of the Central Management database, rather than the Central Management database itself.

Detailed Description

Use this cmdlet to retrieve one or more existing voice routes. Voices routes contain instructions that tell Microsoft Communications Server 2010 how to route calls from Enterprise Voice users to phone numbers on the public switched telephone network (PSTN) or a private branch exchange (PBX).

This cmdlet can be used to retrieve voice route information such as which PSTN gateways the route is associated with (if any), which PSTN usages are associated with the route, the phone pattern (in the form of a regular expression) that identifies the phone numbers to which the route applies, and caller ID settings. The PSTN usage associates the voice route to a voice policy.

Return Types

This cmdlet returns instances of the Microsoft.Rtc.Management.WriteableConfig.Policy.Voice.Route object.


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

Copy Code

Retrieves the properties for all voice routes defined within the organization.

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

Copy Code
Get-CsVoiceRoute -Identity Route1

Retrieves the properties for the Route1 voice route.

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

Copy Code
Get-CsVoiceRoute -Filter *test*

This command displays voice route settings where the Identity contains the string "test" anywhere within the value. To find the string test only at the end of the Identity, use the value *test. Similarly, to find the string test only if it occurs at the beginning of the Identity, specify the value test*.

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

Copy Code
Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}

This command retrieves all voice routes that haven’t had any PSTN gateways assigned. First all voice routes are retrieved using the Get-CsVoiceRoute cmdlet. These voice routes are then piped to the Where-Object cmdlet. Where-Object narrows down the results of the Get operation. In this case we look at each voice route (that’s what the $_ represents) and check the Count property of the PstnGatewayList property. If the count of PSTN gateways is 0, the list is empty and no gateways have been defined for the route.